C Volume 
Management 
Configuration 
Files 



During system startup, tlie Volume Manager starts each Libraiy 
Manager that is specified in the VM configuration file. A Library 
Manager is added to the VM configuration file when you 
configure a Library Manager by using the Imconflg utility. 

This chapter provides detailed information about the Volume 
Manager and Libraiy Manager configuration files. 

The chapter contains the following sections: 

• Volume Manager Configuration File 

• Library Manager Configuration Files 

See Chapter 17 "Configuring Library Managers'' for information 
about using the Imconfig utility. 
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Volume Manager XX'lien you install rhe sofrware, a default configuration file 

Configuration File (vm.cfg) is added to the /usr/epoch/etc/vm direcioiy. 

EMC sets the recommended ^'alues for parameters in the vm.cfg 
file and, in most cases, tliese do not require modification. The 
only time vm.cfg needs to l>e modified is when you add a 
Lil^rary Alanager; Imconfig manages this when you run tlie script 
to configure a Library Manager. 

f-igure C-1 provides a sample vm.cfg file, (Note that comment 
lines begin with the * character.) 

Table C-1 describes the parameters and default values in the 
vm.cfg file. 



Figure C-1 Volume Manager Configuration File 

# The following is a default configuration file for a vmdaf 
# 

# Limitations: 

# o LM^HOST must always be localhost 
i o VM_ALLOW_DUP* must always be no 

# o VM_METRIC* are not used yet 

# o V[-5_L0CAL_CNLy_ACCESS must always say no 
t o VM_AOTK_TYPE may only by RPC_ONIX 



VMJxiAME : vra 

VM_ROOT : /usr/epoch/etc/vm 

YM__^S¥SLOGLEVEL : concise 

yM_WATCHDOG_LMS : yes 
VM^CATALOG_DIR : /usr/epoch/etc/vm 
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# 

Wj_ALLOVJ_DUP_BARCODE_IMPORT : no 
va-l_ALLOW__^DOF_^SEQ_IMPORT : no 
VM_METRlC_INTERyAL : 60 
VMJ-5ETRIC_EXPIRATI0N : 33 
Wi_LOC?,LJ)NLY_ACCESS : no 
VM_AUTH_Ti'PE : RPC^UNIX 

# Field for the offline mount user routine for new media request 
VM_NEW_MEDIAJJSR_ROUTINE : /bin /true 

VI^_VOLFILE_DIR : /usr /epoch/etc/vm 

^1 The CLOG_SIZE value determines how large the vm' s debugging 

# circular clog size is allowed to be. The circular log or clog 

# file is only written to when the \TndaemDn is in debugging 

# inode, a CLOG_SIZE OF 0 MEANS INFINITE, I.E. NOT CIRCULAR 
"vl"l_CL0G_SI2E : 104 857 60 

# The VM__ERASE_LIMIT controls if and how the vmdaemon limits 

# the number of concurrent volume erases per library unit. 

# NONE : no limit on the number of concurrent volume 

f, NUM_DRIVES : concurrent erase daemons are limited to the number 
^ of drives in the LU containing the volumes. 

# KAiF_OF_DRIVES : concurrent erase daemons are limited to half of 

# the number of drives in the LU containing the volumes. 

# If the number is odd, it will be rounded up. 
VM_Er;vSE_LIMIT : NUM_DRIVES 

#The VM_FIKu_AVAILJ4EDIA_INTERVAL determines after how many 

# VM activities search for available media will be done. 
VM^FIND_^AVAIL_MEDIA_IiMTERVAL : 25 

"vM_DUP_NUt^5_ACTIVE : 1 
VM_DUP_STATE : enabled 
VM_DUP_TAPE_PAD : 10 
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iBEGIN_off Jine_0 
LM_START : 0 
LM_N AI^IE : o f f 1 i n e _0 
LM_HOST : edmdoc 
LM_EXEC_OPT : "" 
LMJ3JECT_DEST : offsate__0 
LM_END : 0 
#END^offline_^0 
liBEGIN_off site_0 
LM_START : 0 
LM_NAME : of f s i t e_0 
LM_HOST : edmdoc 
LM_EXEC_OPT : " " 
LM_EJECT_DEST : offline_0 
LM_END : 0 
^)END__of fsite__^0 
#BEGIN^_qntm_^x7 00 __^0 
LM_START : 0 
LH_NAME : qntTn_x 7 0 0__0 
LM_HOST : edmdoc 
LM_EXEC_OPT : "" 
LM_EJECT_DEST : of f ] ine^O 
LM_EKD : 0 
# EN D_^qntm_x 7 00^0 
t BEG I !Ni_hp_c 1 7 xx_0 
LM^START ; 0 
LM_NAME: hp__cl7>:x__0 
LM_HOST : edmdoc 
LM___EXEC_OPT : "" 
LM_EJECT_DEST : offline_0 
LM_END : 0 
#END_^hp_^cl7xx 0 
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Volume Management Configuration Parameters 



Description 



VM_SYSLOGLEVlIL, 



vm_wa']x:hdog_lms 



Identifies the 
s used 



of the Volume Manager. 'Hie defauh 



name is used in system log messages lo'identily tlie process that 
generated the message. 

entifies the full pathname of the vmdaemon. The defauh is set 
sr/epocli/etc.A'm, 



Sets xhe logging level. The default is 
messages 



which logs c 



Enables the vjiidaenion i> 



i setting is overridden at H>',stem .startup. 

nager dae 



Vi\'l_CVl'ALOG_Dll< 



VM_ALli3W_DUP_BARCODlLl.MPOin 



VM_Al.LOW_DUP_SKQJM!^ORT 



VM_METKlC_INTliKVAL 



VM_iVIE'raiC_EXPlMnON 



Specifies the location of the 
default is /u.sr/epoch,''erc/vm 



; wliether duplicate barcodes are allov.'ed within a sen'er. 
The default is no, wliich does not allow you to import a ^'olulne if the 
same barcode ID is akeady in the volume catalog. This ensures that 
ail iDarcoded volumes remain unique within a sen-er. 

Detemiines whether duplicate volume sequence numbers are allowed 
within a seiver. The default is no, which does not allow you to import 
a volume if the same volume sequence number is already in the 
volume catalog. This ensures that all \'olume sequence numbers 
remain unique within a server. 

Specifies the frequency, in seconds, that the vmdaemon records 
metrics. Metrics enable you to gatiier performance results for use in 
trend analysis. I'or example, the vmdaemon could track mount faults 
once per hour and the data enables you to detennine the peak of 
certain activities. The default is 60; the value is ignored, wliich 
indicates that no metrics are recorded. 

Specifies the time period, in days, when metric data should be 
expired. The default is 33 days; this parameter is ignored. 
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Volume Management Configuration Parameters (Continued) 



Parameter 

VM_LOCAL_ONLy_Ac:(:]=,s 



VM_AUTH_'iYPE 



VM_N1;'«'_M I^DI A_l]SR_R Ol m N H 



VM_V01,]-]1JLD1R 



YM_CL0G_S1ZK 



Description 



SpL-cifies wheihej- ilie vmdaenion (as an KPC sen-er) can receive 
seivice i-eqiiests from RPC clients on the network, lixaniplcs of RPC 
clients include: the EDM Lilxaiy Unit Manager GUI, EDM Baclaip and 
I-iSM solhvare, and volume management's CLl. 'J'he default is No. 

Sets the sei-ver authentication policy to RPC_UN1X, which makes the 
vmdaemon check user and group permissions For the session. This 
allows the vmdaemon to restrict functions to clients. A \'alue of 
RPC_NONE disables checking of pemiissions. 

I'ro^'ides a place holder for the user saipt that is executed in response 
to receiving an offline media request for available media. This 
user-specifie(.l routine is executed once for each media request. J-'or 
e.xample, a user can include sending email upon receiving the request 
in this routine. 

Eoi- EMC internal use only. Specifies the pathname that contains 
pseudo media r\-pes. The default is / usr/epoch/etc/vm. Pscudo media 
types are created by using files on a traditional filesystem. 

Sets the ma.Kimum size of the vmdaemon debugging circular log 
(clog) file. The default is 10485760 (10 MB). The vmdaemon writes to 
this hie while in delxig mode. 

Note: Debug mode is enabled by default at system 
Startup. 

Note: EMC Customer Ser\'ice requires VM (and LM) dog 
files to debug a problem effectively. It may be 
necessary to increase the size of the clog file to 
prevent the vmdaemon from overwriting the 
contents of this file. 

Note: Setting the default to zero is not recommended: the 
circular log file will not have any size limitation, 
which can cause serious disk space issues. 

To run in debug mode, start the vmdaemon with the -d ojjiion or l>y 
sending a special KPC request to the vmdaejnon. Once in debug 
mode, the vmdaemon writes to the clog file and continues to wrap 
until it reaches the maximum specified si7.e. WTien the file reaches the 
specified size, the vmdaemon writes to the top of the file. 
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Table C-1 


Volume Management Configuration Parameters (Continued) 


Parameter 


Description 


VM^EMSE_L1MJ'1' 


Specifies how many drives are allowed to perform volume erasures 
per optical library unit. 

Note: This pai'umeler is ignored tor tape media. 
Values include: 

NONE no liniii to tlie numlier of conciirreni volume erasures in a 
libraiy unit. 

l]ALF_OF_DRl\'ES limits the number rjf concurrent volume erasures 
to half of the drives in the library unit. 

NUMJORIVES (the default) limits tlie number of concurrent volume 
erasures to the numfier of drives in the library unit containing 


VM_FlNl)_AVAll._MRD]A_IN'rEKVAi. 


Indicates that if a queued request exists, a search for available 
volumes from the catalog is made only after eveiy n numbei- of V.M 
acti\'ities. (i-iowev-er, a search is done immediately after paiticular 
activities such as import, inject, or inventor^^) 

The default value of n is 25. 


VM_DUP_ N UM_ACri VE 


Specifies the maximum number of concurrent duplications that can 
run on a system. The default is 1. 

The maxinnnn should be no greater than half the number of drives 
that are available to the duplication, 
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Volume Management Configuration Parameters (Continued) 



VM_DUP_S-|ATE 



VK'LDUPJFAPILPAD 



LM_S'1AKT : 0 
LM_NAMH: hp_cl7x) 
LM_HOS'r ; edmdoc 
LM_EXEC_OPT ; 
LM_EIECr_DES1' ; d 
LM_END : 0 



Description 



Specifies whether media duplication is enabled or disabled. 'J'he 
delault is enabled. This field appears only when its default value 
clianges. 

Specifies the amount of label padding applied lo original volumes 
when duplication is enabled. The range is 1 to 10, where 1 is 10 MR 
of pad space and 10 is 100 MB of pad space. 'Hie default is 10. 

This field appears only when its default value changes, 



■ each Libr: 
this poition of vi 



ry Manager configure 
i.cfg are made by lm< 



LM_NAME provides the name of the libran' unit in tl 
maniifacturerjibraiy unit type_serial number. 



LM^HOST specifies 
Manager daemon r( 



ame of the host on which th 
. 'lire defatilt is the localho.si 



virh which a panicular Library 



LM_EXEC;_OPT pi-ovides the optic 
Manager is staned. The default is i 

■file L,M_f=.1ECl _D£ST specifies the name of the Library Manager that 
receives a vokmie when an eject occurs, 'llie eject must always be 
initiated by clicking the Eject button in tlie EDM Library Unit Manager 
and not by the hardware eject lautron. The values are none, offline_0, 
and offsite_0. 
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Library Manager 
Configuration Files 



The Imconfig utility creates a separate directorx- in 
/usr/epoch/etc/lm for each Library Manager chat yoii configure. 
The name of each Library Alanager follows a convention that is 
based on the type of libraiy unit that it supports. 



Library Manager Naming 
Convention 



The Library Manager naming convention is of the form: 

manufacturer jnodel_n 

where: 



'JXvo- to three-cliaraciei' abbi'eviation tliai 
identifies the manufacrurer ofrlie library unit. For 
example, "lip" .stands for Hew^len-Packai'd and 
"atl" stands for ATI Produas. 

(]ode (from iwo to five characters) that identifies 
the type of library unii. For e.xample, ail_452 
supports ihe AC], 4/52 libraiy units with DLT 
drives manufacaired by ATL Products. 

One-digit suffix that Imconfig appends to the 
Library Manager name. The suffix ibr the first 
Library Manager is 0. 'Ibis number increments hy 
1 for each Libraiy Manager t)f tire same type that 
you configure. For example, the first Libiary 
Manager for an ATL 4/52 DTL library unit is 
atl_452_0 and the second instance is atl_452_L 



1'he Imconfig utility copies a template configuration file, 
Im.cfg, into tlie subdirecioiy and modifies the file based on 
input tliat you provide interactively. Imconfig also creates a 
link to the executable file and adds the information about the 
new Library Manager to the Volume Manager's configuration 
file. 
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Library Manager Witliin eacli Library Manager directoiy, Imconfig creates 

Subdirectories several files. During start-up, tlie Libi-ary Manager reads the files 

in its directory to initialize the library unit that it is managing 
and to set up its internal data stnictiu-es. 

Figure C-2 on page C-10 illustrates an example of the Library 
Manager directoiy structure. (Ncjte that though the Hbraiy unit 
in the example ccjntains foiii" drives, only two appear in the 
example, due to space limitations.) 

Refer to Table A-3 on page A-19 for a description of the files 
that reside in each Libi-aiy Manager directoiy. 



Figure C-2 Sample Library Manager Directory Structure 

/usr/epoch/etc/lm 



atl_452_0 atL452_1 offline_0 offsite_0 



Im.cfg 


Im.cfg 


Im.cfg 


Im.dg 


volid.dai 


Nolid dat 


clog 


clog 


do 


dO 


Imd 


Imd 


d1 


d1 


liblni_tnLimbcr 


liblm_tnumber 


rO 




lm_is_open 


lm_is„open 


lmjn_drive_0.dat 


lm_in_dn\ejidat 






lmjn„drive^].dat 


Im m drive l.dat 






clog 


clog 






Imd 


Imd 






liblm^tnumber 


liblm_tnumber 






lm_is_open 
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Library Manager Configuration Each Library Manager has a configuration file tliat contains one 

Parameters parameter and coiTCSponding value per line. A delimiter 

se]3arates each parameter fi-om its \'alue; at least one s]Dace 
appears before and after the delimiter as shown in the following 
example: 

LMJ\'AME : atl_4 52_0 

The configuration file contains parameters that define tlie name 
oi' the Library Manager, liardware addresses of the libraty unit 
and drives, and library unit operating features. 

CAUTION: Do not edit the Im.cfg file manually. The 
Imconfig utility makes aU modilicatiotis to 
library Manager cotifiguration files. If you 
need to make additional modifications to 
this file, contact EMC Customer Service for 
assistance. 

Figure C-3 on page C-12 shows an example of the Im.cfg file. 
This is the default configuration file for the ATL 4 o2 DLT library 
unit. (Note that comment lines begin with the * character.) 

The Im.cfg file is set up during installation. When you change 
the hardware configuration by adding or removing a library 
unit, you need to reconfigure llie software to recognize the 
change. For directions, refer to Chapter 17 "Configuring Library 
Managers". 

Table C-2 describes the Library' Manager configui'ation 
jDarameters and default values in the Im.cfg file. 
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Figure C-3 Sample Library Manager Configuration File 

###generated by Imconfigftt 
#@@ebegin_name@(£@ 
Ll'j_NAME : atJ_4 52_0 

#@@eend_name@e@ 

LM_INLET : 0 

LM_INLET_STATE : enabled 
LM_END_INLET : 0 

LM_INLET : 1 

LM^INLET^STATE : enabled 
I,M_END_INLET : 1 

LM_INLET : 2 

LM_INLET_STATE : enabled 
LM_EtHiD_IKLET : 2 

LM_INLET : 3 

LM_INLET_STATE : enabled 
LM^END^INLET : 3 

* e e ebeg 1 n_othex @ @ 6 
LMJv'OLIDJvlA.P : volid.dat 
LM_DRIVE_^EJECT_BEFORE_MOVE : 1 
LM__BARCODE_CAPABLE : 1 
LM_AUTO_INJECT : 1 
LM_IES_ON_STARTUP : 0 
LM_IES_0N_INVE1^]TORY : 0 

LM__SCAt\^_TIME : 5 
LM_MAX_IDLE_TIME : 300 
LM_14AX_RESIDENT_TIME : 72 00 
LM_MIN_RES1DENT_TIME : 12 0 
LM_DRIVE_CLEAN_TIME : 400 
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LMJ-10UNT__PRI0RITY ; 4 
LM_DISMOUNT PRIORITY : 2 
LKj_INJECT_PRIORITY : 3 
LM_EJECT__PRICRITY : 5 
LM_INVENTORY_PRIORITy : 12 
LMJ«VE__MEDIUM_FRIORITy : 6 
LMJTO_LBL_PR10RITY : 8 
LM_RD_LBL_PRIORITY : 7 

LM_LD_PHYSLOC : Bl lab 

L..M_CLEANER_BARCODE_RANGE : CLN* 

#@eeend_other@@e 
LM_MEDIA_FORMAT : EDM 
#@eebegin_robot@@@ 
LM^LU : 0 
LM_LU_BOARD : 3 
LM_LU_BUS : 0 
LM_LD_TARGET : 0 
LM_LU_LUN : 0 

LM_LU_PHYS_DEV : /usr /epoch/etc/ Im/atl __4 52__^0 /rO 
LM_END_LU : 0 

LM^PICKER : 0 
LM_PICKER_STATE : enabled 
LM_END_PICKER : 0 

#@@eend_robot@@e 
#@@ebegin__^drive@@@ 
LK_DRIVE : 0 

LM_DRIVE_BOARD : 3 

LM^DRIVE^BUS : 0 

LM^DRIVE__TARGET : 1 

LM_DRIVE_LUN : 0 

LM_DRIVE_PHyS_DEV : /usr/epoch/etc/liTi/at 1_4 52_0 /dO 
LM_MEDIA_TYPE : DLT 
LM_DRIVE_STATE : enabled 

LM_DR1VE_ATTR : liii_drive_dirty_query_able 
LM_IN__DRIVE_FILE : lm_iri_drive_0.dat 
LM_END_DRTVE : 0 
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#e@eend__driveiseg 
#e@ebegin drive@@@ 
LM^DRIVE : 1 

LM__DRIVE_BOARD : 3 

LM_DRIVE_^BUS : 0 

1,M_DRIVE_TARGET : 2 

LH__DRIVE_LUM : 0 

LH DRIVE_PHYS_DEV : /usr /epoch/etc/lm/atl_4 52_0/dl 
LMJ^EDIA_TYPE : DLT 
L.M_DRIVE_STRTE : enabled 

LM_DRIVE_ATTR : liri dr i ve_dir ty_ quer y__able 
LM_^II.3_DR1VE_FILE : lm_in_drive_l.dat 
Lh5^END_DRIVE : 1 

#@@eend_drive@@§ 
#§@@begin_drive@e@ 
LM DRIVE : 2 

LK_ DRIVE_^BOARD : 3 

LH_DRIVE_BUS : 0 

LM__DRiyE_TARGET : 3 

LM__DRiyE_^LUN : 0 

LM^^DRIVE_PHYS_^DEV : /usr /epoch/etc/lm/atl^4 52_0/d2 
LM_MEDIA_TYPE : DLT 
LM^DRIVE^STATE : enabled 

LM_DRIVE__ATTR : lm_dr ive__dirty_query_able 
LM_1N__^DRIVE_FILE : lm__in^ dr ive__2 . dat 
LM^END_^DRIVE : 2 

*@@eend_^drivee@e 
ii@@@begin_drive@@e 
LM_DRIVE : 3 

LM_DRIVE__BOARD : 3 

LM_^DRIVE_BUS : 0 

LM_DRIVE_TARGET ; 4 

LM_^DR1VE_LUN : 0 

LM__DRIVeJpHYS_DEV : /usr /epoch/etc/lm/atl_4 52_0 /d3 

LM_MEDIA_TYPE : DLT 

LM DRIVE _S TATE : enabled 

LM_DR1VE_ATTR : lm_drive_dirty_query_able 
LM_iN_DRIVE_FILE : lm_in_drive_3.dat 
LM_END_DRIVE : 3 

#e§eend_drive@@(s 
i'##completed by linconfig### 
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Table C-2 


Library Manager Configuration Parameters 


Parameter 


Definition 


LM_NAME : name 


Name of tlie Libraiy iManager. 'Ilie LM_NAME appears nexi io ihe 
libraiy icon in the Eibrary linits and Drives area of the mM Libran- l.inii 
Manager window, 'flie value is a charaaei' string iliat contains up lo 16 


LM_INLET : ti 
\M INLFT STATE : slate 

i.m_endjnIet : ?! 


State of the inlet when the Libraiy Manager stans up. The value is 
fALENLE-r and LA'LEND_lNl.Er and must be tlie sMic vakie' 


LM__VOL]D_MAP : file name 


Name of the file (volid.dat) that contains a table of the libraiy unit's slot 
contents. 'I'he volid.dat file enables the Libraiy Manager to stan up 
without taking a complete inventojy of the library unit. 


LM„DJ«]VE_EIECI_BEl-ORE^MOVE : 


11 Detennines whether hardware needs the volume to be ejected fi-om the 
drive before the robot moves the volume. 

N'alues for n are 1 (enable, eject needed) oi' 0 (disable, ejecl is not 
needed). 


LM_BAR(:ODEJ]APABEE : n 


Specifics whether the libraiy unit suppons barcodes. The value for ;/ is 
0 (no Ijarcode support) or 1 (barcode stipport). 


EM_AI)1'0_1NJ1EC-1' : )/ 


Configures the librar\' unit's inlet as automatic or manual. 
Values are: 0 = manual inlet and 1 = automatic inlet, 

A manual inlet (that is, hardware-controlled) requires the user to click 
the Inject button before the robot movers the 
\'(3lume horn the inlet into the libraiy unit. 

If the inlet is configured as automatic, the Library Manager polls the 
inlet and moves the volume into the library imiis without an explicit 
command. The time tnten'al in which the inlet is j^olled is specified by 
the LM_SCAN_T1ME parameter. 


l.iVLN(:)JES_ON_S'IAir]l'P : n 
IJMJES_ON_S1i\RTUP : w 
LM_NO_IES_ON jm'EN'l'ORY : n 
LM_lES_ON_INVENlX3irf : n 


Detemtines whether hardware checking occurs (e.g., obtaining the 
status of drives, slots, and inlets) at staraip and during inventory. 

If the values of the parametei's that contain "NO" are set to ] or the 
\-akies of the parameters that imply "YES" are set to 0, no hardware 
checking occurs. 
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Library Manager Configuration Parameters (Continued) 



LM_SCANJ1ME : 



LM_MAXJDLEjnME : n 



LM_MAX jy-SlDEN'f_TIME : 



EM^M 1 N^RESJ Dli Nl 'Jfl ME : 



LM_Dl<lV:E_CLEANjnME : 



Definition 



Time inten at (in seconds) lha! specifies liow often the Eilji-aiy Manager 
polls its work list fwhich includes polling inlets, new requests, and 
cancellations); the default is 5 seconds . 

I'or automatic inlets, the inlet is polled continuously on this inieival. For 
manual inlets, the inlet is polled when yo tu click the Inject button. 

.Maximum time (in seconds) that a volume can remain in the dri\-e affci- 
a dismount request is made. The default value for all drives is 300 
seconds (five minutes), 

Maximum time (in seconds) thai a volume can remain in a diive before 
allowing preemption by a volume of the same priorit)'. 'ilie default 
value foi' HO drives is 120 seconds (two minutes). The default value lor 
lape drives is 7200 seconds (two hours). 

Minimum time (in seconds) that a volume of a lower piioriry can he in 
a dri\'e before allowing preanption for a volume of a highei- priority. 
The default value is 120 seconds for tape (two minutes), 30 seconds for 
optical media. 

t3esignated time (in seconds) in which to clean a dri\'e. The Libi'ary 
Manager .starts verifying whether the cleaning cotnpleted after this lime 
period elapsed. The delaull value is 300 seconds (5 minutes) or 400 
.seconds (over .six minutes), depending on the lype of drive and library 



I.,M_MOlJNTJ'R]ORrn' : n 
LM_D]SMOlINT^PJUORl']'y : / 
LMJNJECT_PMOR]']'Y ; n 
LM_E]ECl_PR]OKriT : n 
LM_lNVENTORY_PR10Rrn' : 



Default priority for mount operations. The value is an integer in the 
range 1-16 (the default is 4) where 1 represents the highest priority. 

Default priority for dismount operations. The value is an integer in the 
rajige ]-l6 (the default is 2); where 1 represents the highest piioiity. 

Default priority for inject operations. 'Hie value is an integer in the 
range 1-16 (the default is 3); where 1 represents the highest prioiity. 

Default priority foi' eject operations. The value is an integer in the range 
1-16 (the default is 5); where 1 represents the highest priority. 

Default priority for mo^'emenl operali(3ns. 'llie value is an integer in the 
range 1-16 (the default is 12); where 1 represents the highest priority. 
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Library Manager Configuration Parameters (Continued) 



Parameter 



LM_MOVE_MliD]UM_PK!OKr)Y : 

LNLWK_LBL_PR]ORri*^' : n 

!.M_I!l)J,BL_PR10RrrY ; n 

l.M_l.U_PHYSLOC : string 

L LLCLEA NER_BARCOD]Z_M NG 1; 
string 



Default ]5riorit\' for laljel wi'ite operations. The value is an integer in tlie 
range 1-16 (the default is 6); where 1 represents the highest prioriU'. 

Default priority for label read operations. 'Jlie value is an integei- in the 
range 1-16 (the default is 8); where 1 represents the highest priority. 



alue is an integer in tli 
s the highe.st priority. 



Default piiority for inventoiy oper 
range 1-16 (the default is 7); wher 

Physical location of the lihraiy uni 
riuming Imconfig, 



Cleaner barcode range. If the value is "N/A" or this ]yarajiieier does ik 
appear in the Ini.cfg file, no assumptions are made for cleaner 
barcodes. 

If the value is "CLN*," any barcode that begins with "CL.N" identifies a 



LMjMEDlA^FOl^MA'J" : strin 

LM_LU : n 

LVLUJ_BOARD i n 

LA'LLILBUS : II 

LM_LIJ_TAKGET -. n 

LM_LU_LUN : n 

LM_LlLl^lrIYS_DEV: 
LM_END_LLi ; n 

LMjnCKER : n 

LM_PlCKEIC.S'fA'n; : slate 
LM„END_P1CKER : n 



Format of the bacfaip data on the tape. Tlie supported value is "EDM." 

Parameters between LM_LU and LM_END_LU (except for 
EM_LL1_P11YSJ3EV) that define the system bfwrd number, I/O bus slot 
number, SCSI target ID, logical unit number (LlIN). All values are 
integers. EMJ.lJ and LMJIND^LU I'epresent the relati\'e library unit 
number and must be the same value. 

E.M_Llj_)MTi'S_DEV provides the full pathname (in a character string) oF 
die pliysical device node for the lil:)rary unit. 

State of the robot (or robot) when tlic Librar\' Manager starts up. The 
value is enabled or disabled. The relative robot number is specified by 
L!V1_P1CKER and L!VLEND_PiCKER and must be the same value. 



Li\1_BARCODE_VERnTCA'nON ; value Specifies wliether the barcode should be vi 
volume is mounted. The value is ignored, 
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Library Manager Configuration Parameters (Continued) 



Parameter 



LM_DR1V.E ; )/ 
LMJ)KI\"i:_BOAR]) : 
LM_DR1\'E_BI'S : n 
LM_DRiVr_TARGF;r : n 
LM_DR1\T_LUN ; H 
LM_DR1\T_PHYS_DE\ ; path 
1 M__MEDIA_1TPE : ralnc 
EM_DR1VE_S-1"A'EE ; value 
LVlj:)Rl\'b_ATrR : siring 
LM_lN_DR]Vi;_E!LR : Jilo naim 

LVLEN])_DRIVE • n 

L,M_l)Rl\']LPnYS_l)I;V : path 



LM_N'lEDlA_*n'PE value 



LM_DRIVE_S'JA'rE ; value 



LM_DRJVE_A'n'R ; string 



EM_IN_DRTVF._FI1.1' 



irvLDRJVE and LM_END_DR1VE represent the relaii\'e c 
and must l^e the same value. 

LM_D]?JVE_BOARD defines the system boaj'd number. 
LM_D]^]VE_BL1S defines the I/O bus slot number. 
EM_DR1VEJAR(^dr|- is the SCSI target ID. 
LM_DR]VEJ.IJN is the logical unit numlier (EIJN). 
Otlier parameters are described below. 



ovides the full pathname fi 
)de for the drive or robot. 



:haracier string) of the physical de\ 



Type of media that die drive supports, To configure a muliifunctioi 
drive, specif' one L.N1_MEDlAjrYPE parameter and value foi' each 
media type:' 

DL'E = digital lineai' tape cam-idge 
DI'F = digital tape format 

M1TC_STK, HlTCUmOSTAR = half-inch tape cartridge 

EO = ei-asable o|Mical disk cartridge 

WORM = write once, read many optical disk cartridge 

mos = ? 

State of the drive when the Library Manager starts up. The value is 
enabled or disabled. 



Indicates whether EDM is to detemiine whether a clri\ 
parameter is not set, EDM does not check tlie drives; 
check die drives directlv. 



is dirty. If Uiis 
J must then 



:s of the 



File name of the file that contains inl'orination abotit the con 
drive, 'llie default is lm_jn_drive_w.dat, where n is the relative drive 
number. Ihe drive content file is used dxiring start up and is updated by 
the Library' Manager each time a volume is moved into and out of a 
drive, if a drive content file does not exist for each drive, the Liliraiy 
Manager creates one during startup time. 
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Library Manager Configuration Parameters (Continued) 



LM_DRn'JLS'rAirrLAn'Eii„MovE ; 



LM_IN]EC(VnMl-OUT ; 



l.M_0FFl.INILM01JNT_ACT10N : 
value 



Indicates whether the drive needs i 
is mounied. 



The default value is 0, r 
explicit siail. 



3e explicitly started after a vn 
1 needed. A value of 1 indie 



Maximum time (in seconds) that the library Manager waits for a \ 
to be insened into the ijilei before returning a timeout error. Tlii 
parameter is used only for libraiy units tliat have software conin 
which LM JNLE'J_lJNL(:)CK_NEliDED specifies. 

Defines the Library Manager; value is offline or offsitc. This par? 
applies only to Lilsraiy Managers without physical librajy units. 



Defin 
•equesi 



■ taker 



voluni 



T upon receipt of a 
'Fhe \'alue is; error, whicit automatically rejects the request, or 
queue, which holds the request in a queue until the request is satisfied 
r manually rejected. 



This paran 



applies only to Librai 



Ma nag 



viihoi 



physical 



LM_OFF!JNlLMOlINT_li.SlLROliTlNE Specifies the pathnar 
: path For example, a user i 

the operato)' when a 



■ could he ■ 



e that defini 
'ritten to ser 
made for ai 



applies only to Libraiy Managers without physi 



The LMJNLET_IGNORE_ON_OPEN Ihe LM_INLF.TJGNORE_ON_OPEN volume enables you to 
Parameter re-inject volumes that you just ejected into the libraiy unit 

automatically, by just opening and ckxsing tlie inlet, '['he default 

For this capability' is 0: 

EM_INl.ET_IGNORE_ON_OPEN : 0 
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When set to the default, tliis parameter does not appear in xhc 
hn.cfg file. However, you can .set die parameter to 1, which 
removes thi.s automatic re-injection feature. You must then 
remove media from the inlet and then close the inlet before 
ejected volumes can be I'e-injected . 

To set the parameter to 1, add this parameter to the Im.cfg file 
manually, anv^vhere between "begin_other" and "end^otlier." 
For example: 

#e@@begin_other@@e 
LM^V0LIDJ>4AP : volid.dat 
LFi__DRIVE_EJECT_BEFORE_MOVE : 1 
LM__BARCODE^^CAPABLE : 1 
LMJiUTO_INJECT : 1 
LM__IES_ON_STARTUP : 0 
LM_IES__ON_INVENTORY : 0 
LI^'!_iNLET_IGNORE_ON_OPEI\i : 1 



#eeeend_otheree@ 



/usr/epoch/etc/'lm/offline_0. Figure C-4 shows the pai-ameters 
that its configuration file contains. Refer to Table C-2 on page 
C-15 for a description of configuration parameters. 



Offline and Offslte Library 

Managers 



The offline and offeiie Libraiy Managers each has its own 
configuration file. Each Library Managei" is descrilDcd below. 



Offline Library Manager 



Tire offline Library Manager resides in 
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Offline LM Configuration File 

###generated by linconfig### 

#e@@begin_naineee§ 

LM NAME: offline_0 

#eeebegin_other@e@ 
LM_SC ANYTIME: 5 

LM__CFFLINEJ-10UNT^ACTI0N : queue 

LM J3ETL1NE_M0UNT_USR___R0UTINE : /bin/ true 

*eeeend^other@ee 

###completed by Imconf igt## 



The offsile Library Manager resides in 
/u.sr/epoch/'erc/lm/offsife_0. Figure C-5 sliows a sample 
configuration file. Tiie parameter LM_ATTR indicates thai the 
Library Manager is offsite, as opposed to offline. The parameter 
LM_OFnJNE_MOUNT_AOTON is described in Talkie C-2. 



Offsite LM Configuration File 

###generated by lmcorifig### 

#@@@begin_name(B@e 

LM_NAME : offsite___0 

#ee@end_^nanie@@e 
#e@ebegin_^other@@@ 

LM_ATTR : offsite 
LM_OFFLINE_MOUNT_ACTION : error 

#@e@end_other§e@ 
###completed by lmconfig### 
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Directives 



The work item directive specifies which filesy'stems, directories, 
and files to back up on the client, and which to exclude. EDM 
]3ackup's autcjconfiguration feature builds these directives for 
you automatically. 

When backups are am, all directives, which am consist of 
macros, are tran,s]ated into tlie expanded findxcpio syntax; the 
ftndxcplo program scans the client filesyslem and reads the 
client data. (Refer to the findxcpio man page for detitiled infor- 
mation alx>ut the command.) 

This chapter explains the findxcpio macros and expanded 
syntax. 

• Work Item Directive 
e Logical Operators 

• Macros 

• .Syntax tc^ do Back Up 

• Syntax to not Back Up 
» Evaluation Shortcuts 
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Work Item Directive You can use the Work Item tab in the EDM Backu]o Configu- 

ration window to adjust tlie specification for the directive(s). 
The interface builds the dii"ectives for you (with macros). In 
addition, you can also directly specify the findxcpio directive 
in the Work Item 0]Dtions VA'indow wliich is accessed tlirough 
the Work hem tab in the EDM Backup Configuration window. 
(You can also edit the directives in die eb.cfg configuration file.) 

The general formal of the vv'ork item directive is: 

( 

"files to back up"; 

This statement lias tliree fields: 

• Work item name-, specifies a unique work item that 
indicates the client's name and perhaps a set of files to be 
backed up. 

• Client name: specifies the client name. 

» Files to back up: specifies die client's files that you want to 
back up, Cenain findxcpio qualifiers can be used after the 
specif)'ing file names, to further refine which files are to be 
backed up. 



Logical Operators The findxcpio qualifiers include logical operators that enable 

you to expand llie file specifications with evaluation statements. 
'I'hese operators are: 

« -o (or) 

• ! (not) 

• -a (and) 

I'he -a operator is not required; it is implied when two or more 
evaluation statements occur in a row. 
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EDM Backup provides a set oi' macros to use in place of die 
findxcpio syntax. The macros simplilV specifying what files to 
back up and wliich to skip. Tliey are defined in the startfind 
script. 

The findxcpio command uses arguments that are similar to the 
Unix find command, llierefore, all "DO..." macros must be 
positioned tefore other macros, such as "PRUNE...'' macnjs. 

Note: Simpler representations of these macros are 

ax^ailable in tlie Work Item Vdh of the EDM Backup 
Configuration %\dndow. 

Table D-l lists basic macros and theii- expanded findxcpio 
syntax. In these statements, substitute the name of a filesysiem 
for/i. 



Basic findxcpio Macros 


This Macro... 


Expands to this findxcpio Syntax 


I'iOO'l'DlR 




1)0_1'8 Js 


_fs 


DO_PA'iH fs 


_fs 


DO_Dlli/T 


__ts 


DO_HLE fs 




i^lUJNJLPATH /s 


"\t -patli", Js, "-pmne -o -true \)" 


l^RUNE_DlR./s 


"\{ \! -name", Js, "-prune -o -tme \)" 


I'KUNE.FILE fs 


"\f \! -name", Js, "-pmne -o -true \)" 


I.OCAL_FS_ONLY 


"-xdev" 


NO_WS 


"■\( -fstype nfs -pmne -o -true \)" 
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Each ol the i'ollowing examples shows how lo use ihc macros 
that are listed in Table D-1 in a work item directi\'e: 

e To bacli up the root (/) filesysiem, you enter tlie work item: 
work Item: "cadl-all", "cadi", ROOTDIR; 

» 'I'o back up the /home filesysiem and all files and direc- 
tories under it, you enter tlie work item: 
work item: "cadl-all", "cadi", 
[>0_PATH ( " /home " ) ; 

e To skip any files in /rmp, you enter the work item: 
v.'ork item; "cadl-all", "cadi", 
PRUNE_PATK ( "/tmp" ) ; 

« To back up all filesystems in the root (/) filesysiem and to 
skip any NFS files, you enter the work item: 
work item: "cadl-all", "cadi", 
DO__PATH {"/") ,NO__NFS; 

• To back up all filesystems in the root (/) filesysiem, and to 
skip any files named core, you enter the work item: 

DC'_FS{"/") , PRUNE_FILE{"core") ; 

• To back up only files in a particulai- filesysiem (for example, 
/iisr). you etiter the work item; 

work item: "cadl-all", "cadi", 
DO_FS ( " /usr " ) , LOCAL_FS_ONLY ; 
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Compound Macros 


Combining tlie macros in Table D-L EDM Backup provides die 




Following compound macros. 


Table D-2 


Compound fmdxcpio Macros (1) 


This Macro... 


Expands to this findxcpio Syntax 


NO_'l'MP_Fll.ES PRUNILIWIH I 


:"/mijy'). PRUNEJ'ILE ( "\'-" ). PRIJNILI'ILE ( "\*\'"' ) 


NO^AUTOMOUNT PHUNILI'ATl 1 i 


:"/ne!"), FRUNE_I'AT11 ("/tmpjnnt"), PRUNE J'ATll ("/nFs"j 



Each of the following examples shows how to use the macj^os 
thai are listed in 'Fable D-2 in a work item diirctive: 
• To back up files in the root (/) filesystem, and to skip files 
in the temporaiy direcioiy (Amp), files that end with a tilde 
(~), and files thai start with a pound sign (-). you enter the 
work item: 

work item: "cadl-all", "cadi", 
DO^PATH ("/"), NO_TOP_FILES ; 

« To back up files in the root (/ ) filesystem, and to skip any 
files in the /net, /tmp_mnt, or /nfs directories, you enter the 
work item: 

work Item: "cadl-all", "cadi", 
DO_PATH ("/"), tro___AUTOMOUNT ; 
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EDM Backup also pro\'ides additional compound macros that 
combine the maci'os diat Table D-1 and Table D-2 ccjntain. The 
following table lists the five ccjmpound macros and .shows their 
expanded findxcpio .-n'ntax. 


Table D-3 




Compound findxcpio Macros (2) 


This Macro... 




Expands to this findxcpio Syntax 


R()0'i_ONl.Y 


DO_ 


.PATH( "/"), IOC ;a1._1',S_()NIA' 


LOCAl,_r)]SK 


DO_ 


PATH ( "/") , N 0„ A IJTOMO l' NT. N 0_ NFS 


SYSTHM„F1LES 


DO_ 


MmCV /usr"), NO^AUTOMOUNT LOCALJ'S__ONLY 


IJS1-;]LFILES 


D()_ 


JWJ'HC'/homc"), NO_.'™P_)=iLES, LOCAL_FS_ONlA' 


LOCA).,_FILES 


D0_ 


.IWITK"/"). "NO_NFS 



Each of the following examples shows how to use the macros 
that are listed in Table D-3 in a work item directive; 

• To back up only local files in the root C/0 filesystem, you 
enter the work item: 

work item: "cadl-all", "cadi", ROOT^OHLY; 

• To back up all filesystems on a client's local disk, and to 
skip backing up any automoimted or NFS filesystems, you 
enter the work item: 

work item; "cadl-all", "cadi", LOCAL_^DISK; 

• To back up two local filesystems, root (/) and /usr, and to 
skip any NFS-mounted filesystems, you enter the work 
item: 

work item: "cadl-all", "cadi", SYSTEM_FILES; 

• To back up only the local filesystem and to skip any 
temporary files, you enter tlie work item: 

work item: "cadl-all", "cadi", USER_FILES; 

• To back up all filesystems on the local disk, and to skip any 
NFS filesystems, you enter the work item; 
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work item: "cadl-all", "cadi", LOCAL^Fi LES ; 



SyntSK to do Back Up The findxcpio command options makes it easy to tell EDM 

Backup t(3 search for certain types of files for backup. 

When specifying a client backup list, the simplest backup file 
specification is '■/"■ - which means to start at the top of the 
filesystem and back up all files and directories. In addition to "/" 
you can specify otlier qualifiers to select or deselect files. 

For example, to specify to have the backup program back up 
only files it finds under that are .c files, you u.se the -name 
cjption: 

This file specification checks for all .c files. When EDM Backup 
locates .c files, it backs them up. When EDM Backup finds files 
that are not .c files, it passes over them. .Note tlie use of single 
quotes around the *.c expression. The quotes are required 
because the iisterisk (") is a special character to the shell and the 
quotes prevent the * irom being expanded pi-ematurely. 

Suppose you want EDM Backup to copy the files that are stored 
on a fileserver that lielong to a particular user. You use the - 
user option with the name of a user (karen): 
vjork item: "atlasl", "diskl-all", "/ -user karen"; 

This file specification checks for all files under the / directory 
that karen owns, and backs them up. EDM Backup pas.ses over 
all files that the user karen does not own. 

Similarly, to select files tliat belong to a particular group, you 
use the -group option. To back up all files that tlie doc group 
owns on the filesei"ver atlasl, you enter: 

work item: "atla.sl", "disk2-all", "/ -group doc"; 
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This file specification checks for all files under tlie "/'" directory 
owned loy membei'S of the doc grovip, and backs them up. EDM 
Backup ]iasses ovei' all files that members of groii]T doc do not 
own. 

To select files I'or backup tliat contain a certain number of 
blocks and tliat have been accessed within a certain number of 
days, use the -size and -atime options. For example, to select 
files that contain 30,000 blocks (512 bytes each) and were 
accessed in tlie last 72 hours, you enter: 

This file specification checks for files under the "/"' directory that 
contain 30,000 blocks and were accessed within the last 72 
hours (specified by the value -3 because each 24-hour period is 
represented by a value of 1) and backs tliem up. EDM Backup 
passes over any other files. 

To select a certain type of file for backup that was changed 
within a certain number of hours, use the -type option and the 
-ctimc option. For example, to select symbolic links (1) that 
were modified within the last 48 hours, you enter: 
v.'ork iterr,: "cadl-all", "cadi", "/ -type 1 -ctime - 

This file specification searches for all symbolic links iliat were 
modified in the past 48 hours (specified by the -2 because each 
24-hour period is represented by a V) and backs them up. 
]ia.ssing over any other files. 

On an HSM system, to select only staged files (files with a 
.staging ID #] filled in), u.sc the -staged option: 



Syntax to not Back Up The findxcpio command options make it easy to tell EDM 

Backup to exclude cenain types of files from the backup list. 
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Foi- example, if you want to add a check so that EDM Backu]^ 
does not back up a client's NFS filesystems, you add the evalu- 
ation for the filesystem t>'pe NFS using the -fstype and -prune 
options. Hie -fstype option directs EDM Backup lo search for a 
particular filesystem type. The -prune option directs EDM 
Backup not to descend into subdirectories, but continue evalu- 
ating other ftlesystems for backup. To direct EDM Backup not to 
copy NFS filesystems under the "/" directory yc;u enter; 
work item: "cad]-all", "cadi", "/ \( -fstype nfs -prune -o -true \)"; 

Note: The use of -fstype nfs -prune is not recommended, 
because it is impossible to i5re\'eni an occa.sional 
descent into an NFS filesystem. 'The better approach 
is to specif)' individual filesystems, each with the - 
xdev option. 

Tliis file spectficalion checks lor N1"S filesystems, and when 
EDM Backup finds an Nl'S filesystem Unie) then the evaluation 
continues to the second statement, which is -prune, -prune 
always evaluates lo true and causes tlte seai'ch to stop at the 
NFS filesystem mount point, and to skip over it. If the files are 
not NFS (false), the evaluation proceeds to the second statement 
(-0 -true), which evaluates to true and directs EDM Backup to 
ccjpy the files. 

If your site uses automouni, and you find that )'ou have timeout 
problems using the previous file specification, use tliis synmx: 

work item: "cadl-all", "cadi", "/ \( -path /net -prune -o -path /nfs -prune -o - 

path \ /tmp_mnt -prune \) -o -true"; 

Note: Although tliis line appears as multiple lines in this 
example, it must be specified on one line in the 
configuration file. 

This file specification checks for files in three paths (in this 
example, /net, /nfs, and /tmp_mnt). When EDM Backup finds 
one of these patlis (true) then the evaluation continues to the 
second statement (-prune), -prune always evaluates to ti'ue 
and causes the search to stop at the specified path and skip 
ov^er it. 



EDM Software Reference 



findxcpio Directives 



Suppose you do not want to back up a clients /'tmp and 
/Lisr/tmp directories in the "/'' directoiy. To add checks ibr these 
directories you use the -path option to specify die pathnames 
to exclude. You specify* tlie -o option (meaning or) to direct 
l-.DM Backup to exclude either directory: 
work item: "cadl-all", "cadi", "/ ( -path /tmp -o -path /usr/tmp \) -prune -o - 

This file specification verifies whetlier the dii'ectoiy is /tmp or 
/usiVtmp. If tlie director^' is neither (false) lite evaluation stops 
and EDM Backup copies the file to the backup. If the directory 
is /tmp or /usr/tmp (true) then the evaluation goes to the 
second statement -prane, which always evaluates to Inie and 
causes the search to stop at the /tmp or tlie /u.sr/tmp directory. 

Stippose that in addition to not backing up the /tmp or /usr/tmp 
directories, you do not want to back up editor files and core 
files. To specify' this, you u.se the -name option to add checks 
for editor files (*-) or core files: 

work item: "cadl-all", "cadi", "/ (-path /tmp -o -path /usr/tmp \) -prune -o ! {- 

name -o -name core)"; 

The first part of the file specification, as explained in the 
previous example, checks whether tlie dii'ectory is /imp or 
/usr/imp, and does not copy the contents of the directon' if it is 
eitlier directory. The second part of the file specification checks 
foi- files that have the name *~ or core {-name). This statement 
instructs EDM Backup that if the files are not editor liackup files 
('-) or core files (rme) then back them up. If the files are one of 
these (false), do not back them up. 

Suppose you want to instruct EDM Backup not to cross 
filesystem boundaries, which excludes from backup any 
filesystems that ^i^e not explicitly listed. You can use the -xdev 
option I'or this purpose: 

work item: "atlasl", "diskl-all", "/ /usr /homes - 
xdev"; 

Note: If NFS timeouts cause backups to fail, tr\- using tlie 
-xde\' switcli. 
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This file specification checks for the specified filesyslems (/. 
/usr, and /homes) and instruct EDM Backup not to ci'oss 
fiiesysteni boundaries, and so, to only back up the listed 
filesystems. Because the file specification includes the '■/ ' 
filesystejii, if the -xdev switch is not included, EDM Backup 
backs up eveiything in ilie namespace, including NFS-mounted 
filesystems. 



Evaluation Shortcuts In certain cases, the findxcpio evaluation process can skip 

parts of the file specification in the work item directive, saving 
time and preventing unwanted side-effects. The ftndxcpio 
program saves time by quickly eliminating directories and files 
that are specified for exclusion from the backup list. In doing 
so, the program avoids unwanted side-effect.s because it does 
not act upon the second half of the expression. 

Here are the two cases v^'hen findxcpio does not bother with 
the second half of a directive. 



False and in directives with an and in the evaluation, if the fir.si statement 

evaluates to false, ftndxcpio short circuits the evaluation and 
ignores tlie second half of the directive (-prune). 

Consider this work item directive that sj^ecifies not to back up a 
client's /'tmp and /usr/tmp directories; 

"/ \ (-path /tmp -o -path /usr/trap \) -prune o - 

In the first part of this directive that contains the implied and, 
when findxcpio finds that a directory is not /tmp or /usr/tmp 
(false) tlien findxcpio short circuits and does not evaluate the 
-prune option. On tlie other hand, if the directoiy is /tmp or 
/usi'/lmp {/rue) then findxcpio evaluates the -prune option. 
(The -o -true statement directs EDM Backup to copy files that 
are not /tmp or /usr/tmp.) 



"cadl-all" 
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In directives with an or evaluation (-o), if the first statement 
evaluates to true, findxcpio short circuits the evakiaiion and 
does not evaluate the second half of the directive. Thus, in tlie 
following example, if the directoiy is /tmp {Jnie) tlien 
findxcpio does not check for the second type of files 
(/usr/tmp), but goes directh' to the -prune option: 
"/ \ (-path /tmp -o -path /usr/tmp \) -prune"; 
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Access Control List (ACL) 



allocation request 



archive setting 



autochanger 



Provides an enhanced level of security for UNIX files. An ACL 
extends the standard UNK permission settings beyond owner, 
group, and other. .\n owner of a file can permit or deny access 
lo specific users and groups. 

l^equest for a volume sent by an application. The volume 
characteristics ai-e specified in the accompanying volume 
template. 

Sample flSM watermark setting tliat is intended fo)' filesystems 
who.se files are written once and rarely, if ever, read. 1'he 
file.sy.stenrs data will typically be staged-out and rarely, if ever, 
staged back in. lliis would be the case if large amounts of data 
are gathered every day and quickly "archived" off of tlie 
magnetic disk. Other sample watermark .settings include cached 
setting and random setting. 

Robotic mechanism inside a library unit thai physially moves 
media into ajid out of slots and drives. Sometimes referi'ed lo as 
a "picker" or "robot." 
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automatic scheduling Function that automatically schedules incremental backups as 
welJ as some full backups in order lo back up each work item 
each !iighl. It provides a full liackup of each work item cjnce 
within the relation period. It attempts to distiiluite the work so 
that each night's backups will operate for approximately die 
same lengtli of time. See also custom scheduling. 



backup activity monitoring Allows viewing and management of active, successful, and 
failed work items through the 1£DM grapliical user interface. 



Bacl<up Activity Wizard l^nables you to stan new, queued, or failed backups, stop 
running backups, or manage the backup queue, .Acce^^s this 
wizard from the EDM Main window. 



backup catalog Group of related files that maintain a continuing backup history. 

A catalog identifies a backup at die file level by recording the 
names and atti'ibutes of each file on the client sy.stem at the time 
of the backup. Backu]^ catalogs also keep aack of tlie location 
of backup data for each file tliat was selected for backup. 



backup catalog delta Contains a condensed backup catalog with infonuation that 
differs only fi-om the previous backup catiilog files. 



backup configuration Set of parameters on the backup server used to define what 
data gets backed up, when it gets backed up, to where it is 
backed up, how backups are processed, and who can run 
backups and restores. These parameters are edited through the 
Backup Configuration window and stored in the 
/usr/epoch/EB./config/eb.cfg file. 



Backup Configuration windovs? Window m the EDM graphical user interface for editing tlie 
backup configuration. 
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Backup Configuration Wizard Enables you to configure a network, Symmeulx Path, or 

Synunetrix Connect backup ol' filesysiems or a database. It 
supports all clients. You access lliis wizard tlirough the Main 
windo\A' of die EDM GUI. It leads you step-by-step through the 
configuration process. 



backup levels 1-9 Specifies a backup in which EDM Backup copies only those 
files that changed since the last backup of a lower level. 



backup media Media for .storing backup data. Parameters for the backup media 
are specified in die traiJset and trail of the backup configuration. 



backup saveset EDM Backup creates a saveset record foi- each work item it 

backs up. A saveset record contains the template name, work 
item name, the backup level, start and completion times, 
expiration times, and the backup trail. The saveset record is 
used to find the volume containing the backup data and tlie 
associated backup catalog. 



backup saveset record Data saved on backup media from a single backup of a single 
work item. 



backup schedule template Specifies all the inibrmation about how to perfomi a backup. It 
includes the work groupfs,) to backup, the rotation period and 
backup shift lengths, the trailsets on which to store die backup 
data, and the backup schedule tliat dictates a backup level for 
each day. See also template. 



backup server EDM server on a network that contains the client, work item, 
media, schedule, and server configuration information. 



backup shift Parameter in the template of the liackup configuration. It 

specifies tlie desired amount of time for backups to run in each 
24 -hour period. 
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backup trailset Aho called media set. Defines the media trails to which the 

backup data is sent and the type of media to use. It also defines 
liow long to save the backup data and its associated elements. 
See also trailset. 

bad file llle thai changed during backup or a file thai is corrupt. EDM 
Backup tries tliree times before marking a file bad. 



baseline backup With baseline backups, you back up all of your most stable 

files, which, at minimum, consist of all tlie files that are staged 
out to the staging media. From that point on, you perlonn 
backups relative to the ba.seline; that is, theba.seline backups 
take care of the data that is staged out, while the regular 
backups take care of everything else. 

bitfile LJninteipreted .stream of b^Tes that contains the staged-out 

portion of a file. A single bitfile can hold die contents of a single 
client file or the contents of multiple files, A bitfile is uniquely 
identified by a bitfile ID and a store ID. 

bucket When EDM Migration stages out a file, it logically divides the 
file into a number of segments known as buckets, which can 
then be individually acce.s,sed. 

bulk staging in I^JSM, bulk staging reduces each ftlesysiem's magnetic disk 
utilization to a predefined low watermark (LWM). Bulk staging 
is another name for periodic staging. 



cached setting Sample HSM watermark setting intended for filesystems in 

wliich reiids outnumber writes, and a relatively predictalile set 
of files are read. Tliis setting takes advantage of migration's 
ability to keep the most recently-accessed files on magnetic 
disk, tlius ensuring optimal performance. Otlier sample 
watermark settings include archive setting and random setting. 
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catalog See backup catalog and volume catalog. 

cataloged backup Method of backup that updates the system administration 

database with information about tlie backup (i.e., tlie name of 
the template and llie volume 113 of tlie backup volumes). 

client Workstation or fileserver on a netwo]-k that accesses the EDM 
server to back up and restore filesystem and database data, and 
optionally, migrate files. 

client software See local client softvv'are and remote client .software. 



client store in HSM, a collection of files that have migrated from a single 
network client to the EDM server. Tlie client store can reside 
Vkithin any stageable filesystem on tlie EDM fileserver, Es'cry 
client store is associated with a store ID and a bitfile ID. 

compaction in IISM, the process of eliminating stale space on volumes in a 
staging trail and coasolidating the staged files onto the 
minimum number of necessary volumes. Compacted volumes 
can then be erased and reused. 



configuration See backup configuration. 

cross-client restore User-initiated restore of their own backed up files on one client 
to their own directory on a different client. 

custom scheduling Explicitly .schedule backups for particular days of the week, 
month, or other schedule period. (As opposed to using 
automatic scheduling, which schedules backups u.sing general 
parameters and processing algoritlims.) 
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data access pattern 
database work item 

day of rotation 

demand staging 
device node 

disaster recovery 
domain 

EDM {EMC Data Manager) 



Refers to the frequency in which .staged data is accessed. Data 
access patterns include three categories: archive, random- 
relrieve, and general purpose. 

Specifies which client databases you want to back up. You can 
specify which filcsystems, directories, files, and raw partitions to 
include or exclude for backup. See also work item. 



Rotation option within custom .schedule that lets you schedule a 
period that is not a multiple of 7 days. 

Stage-out that occurs when the high watermark is reached. 

Special file, located in /dev. that acts as a pointer to a device 
driver. It associates a location, t)'pe, and access mode with a 
pliysical device. 

Recovery procedure for wlien die bacltup sender's own di.sks 
crash. Also ajDplies to crashed disks on network clients. In both 
ca.scs, some EI^M .software might have been lest, requiring extra 
M'ork before performing the data recovery witli F.DM Backup 
Restore window. 



In the GUI, reports can be designed and run for the local EDM 
or for an EDM domain of multiple EDMs. A domain consi.sts of a 
domain master EDM madiine and mukiple EDM machines who 
agree to participate. 

EMC's hardware product Ibr use as the backup sen-er. Provides 
nerwork backup and restore widi automated management of 
media. Contains the EDM Backup software and optional HSM 
software. 
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EDM Backup EMCs software module for network backup and restore. Its 

interfaces include the EDM Backup Configuration window and 
the EDM Restore window. 



EDM Backup client Workstation or filesystem on a network that accesses the seiver 
lo backup and restore files. See also remote client software. 



EDM HSM EMC's distributed liierarchical storage management application, 
The product consists of several software modules that support 
local and network migration. 



EDM Migration EDM Migration provides migration services iDCtween an EDM 
server and peripheral devices, .such as optical or tape libraiy 
units. It also provides HSM ser\'ices for other file servers and 
woi'kstations 0!i the network. 



EDM transfer protocol The connection metliod, under control of tlie edmlinkd 

daemon, used by EDM for installing and communicating with 
supported clients. On supponed clients (see the current EDM 
Release Notes) this replaces use of remote shell. 



EDM Volume Management Underlying software of tlie EDM Library Unit Manager interface 
that manages volume allocation, drive scheduling, and tracks all 
removable media for EDM Backup and optional HSM applica- 
tions. See also Volume Manager and Library Lnit Manager. 



EMC Data Manager (EDM) EMC's hardware product for use as the backup servei-. Provides 
network backup and restore witli automated management of 
media. Contains the ED.M Backup sofrft'are and optional HSM 
software. 



emxattr file HSM extended attribute file. A file used by HSM that contains 
information about files that have been staged out. 
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erasable optical (EO) disk Rewritable storage medium that uses laser technology to write 
data onto the disk. Also refen-ed to as a magneto-optical disk. 



event-driven staging Metliod of staging tliat reduces a filesystem's magnetic disk utili- 
zation to a predefined low watermark. Event<lriven staging 
occurs automatically when a filesystem reaches a predefined 
high watermark (Hmi). 



expire backups Process that enables old data stored on backup media to be 
oveiwritten with new data, which includes deleting online 
catalogs Irom the backup sei'ver's disks. 



expire catalogs Process dial deletes online catalogs from the backup server';' 

disks, which can be done witli or without expiring backups. 



expired media "Expired"' is the media state that signifies a piece ol' media has 
exceeded its maximum numbei' of uses. 



explicit staging Metliod of staging that is initiated manually by users who want 
to selectively stiige out one oi" more files as a groLip. 



fencepOSt Poition of a file tliat remains on magnetic disk after the first 
stage out. 



file restore Copies a client's backup files from the backup sen'er's media to 
the client's disk. 



filesystem Contains tlie files and directories on each individual disk 

partition. Hie "filesystem" refers to the overall system directory 
tree that merges tliese filesystems into a single hierarchy. 
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filesystem backup Backup of filesystems over the nenvork, using core EDM 

Backup functionality. Backup of data designated by filesystem 
work items. 



filesystem work items Defined unit of data to be backed up, con.si5ling of one or more 
filesystems. Each work item is uniquely named and specifies the 
filesystems to he backed up. 



full backup Copies all the scanned clieni files, independent of the time of 
dieir last backup or tlieir locatic^n, to the backup sewer. 



green zone Disk utilization level that is between the low and high water- 
marks. Hie green zone should l^e large ejioiigh to hold the 
average number of disk blocks used in a day including botli 
new files and previously inactive (siaged-out) files that are 
accessed (staged-in). 



Hierarchical Storage Management Collection of teclmiques used to effectively manage a hierarchy 
(HSM) of storage media such as RAM, magnetic disks, optical disk and 
tape. HSM uses techniques sucli as attempting to keep the most 
frequently accessed data on the highest speed media (highest 
speed usually implies highest cost), less frequently accessed 
data on the next highest speed media, continuing with this 
model until the least frequently accessed data is on the lowest 
speed and cost media. 



high watermark (HWM) Preconfigured disk utilization level that, when reached, cau.ses 
HSM to immediately stage otit enough files to secondary storage 
to reach the low watermark (LWM). 



import Metliod of moving A'olumes among servers. Tlie volume 

management import process reads tlie electronic volume label 
and adds it to the volume catalog of the receiving sender. 
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incremental backup Backup methcxi that copies only tliose client files that have 
changed since the previous backup of any level. 

inode UNIX file's direcloiy information, for example its attriliiitcs or 
nieta-data. 

keyboard focus indicates tire window or element within a window that recei\'es 
keyboard input. 

labeled volume Media that has teen given a volume label. 

library unit Robotic llbraiy unit that automatically manages the placemeni 
of cartridges. Most librdr\' units are equipped with an inlet to 
insert and eject media, robotics to physically move media, one 
or more internal drives, internal storage slots, and in sotne 
models, a barcode scanner. 

Library Unit Manager Process that manages volumes located in physical libraiy units 
and offline and offsite locations. A library Unit Manager 
manages drive .scheduling, volume mounts and dismounts, 
volume injects and ejects, and library unit inventories. See also 
offlinej) and ofi'site _0. 

Library Unit Manager Part of the EDM graphical user interface that allows adminis- 
Window trators to label, allocate, and acquire infonnation about all 

volumes in use for backup and, optionally, HSM. Started from 
the EDM Main window. 

life cycle of media See volume life cycle. 

local client software Softvi'are located on tlie bacloip sen'er tliat scans iLs disks and 
copies the data for backup. See also remote client software and 
server software. 
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local migration surging of filesystems from the EDM server to a tape or optical 
librai'v. See also network migration client. 

logical data Data that is identified either at the file level (filesystem data) or 
as a database entity. 

logical unit number (LUN) Last part of a SCSI addr&ss (channel, target ID. 1.1 ]N). LUNs arc 
numbered 0-7. 

low watermark (LWM) Le\'el to which HSM lowers filesystem utilization as tlie result of 
a demand staging run. 

manual backup schedules backups from the command line using the ebbackup 

command and the names of one or more work items or work 
groups. 

maximum concurrent Backup configuration parameters for limiting concun'ent 

backups processing of work items at varjc:)us points in die system. There 
is such a parameter for: tlie server software as a whole, each 
trail, local client solVsvare, and each remote client software 
(which applies to network backup of filesystems only). 

media duplication Feature of the EDM server that enables you to create a duplicate 
set of backup media automatically after each backup session. 

media list Displays information for each volume that the Library Unit 

Manager contains. By default, die media list includes the lil^rary 
unit name, drive, slot number, and volume information (name, 
barcode, and sequence number), and status of volume sched- 
uling. 



EDM Software Reference 



12 



dia rotation I'or each trail, a new tape cartridge is started at the beginning of 
a new rotation period. This way, a set of tapes is created for 
each rotation period tliat just holds data from lhat period of 
lime. Each such instance of the trail is called a media rotation. 

media set Set of media. See trailset. 



media type Type of pliysical storage medium such a 
(DLT) cartridge. 



; digital linear tape 



meta key User-dcfinable key ihat you can map to any key on your 
keyboard. Most X window applications include a default 
mapped Meta key. Use the xmodmap command to dis]3lay the 
key tnap for your keyboard. 

migrated data Data that IISM has moved from one location to another. Other 
terms used are staged data or staged image. 

migration Process of automatically or manually moving data from 

magnetic disk to secondaiy storage. Migration is .synonymous 
with .staging. 

migration server EDM with HSM option. Contains the client, work item, media, 
schedule, and server crjnfiguration information. In addition, the 
Migration Server contains specific watermark information on 
when to stage files out from local storage to other storage media 
(e.g., optical or tape storage). 

network backup Bacloip of filesystems over the netw^ork, using core EDM 

Backup functionality. Backup of data designated by filesystem 
work items. 



network migration client Workstation or fileserver on the network that has data managed 
by EDM Migration software. 
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obsolete work items Alter antocoiifiguralion, work items (filesysiem work items) that 
no longer validly designate a cuiTent filesyslem or a raw 
paitition. Backup of these work items will fail if they are not 
moN'ed out of a work group and assigned to a template. 



Offline_0 offline I.ibraiy Manager (offline_0) keeps track of volumes that 
are located outside a physical library unit, usually in a nearliy 
storage rack or shelf. A volume Jogically enters the offline 
Library Manage]- when you eject a volume horn a physical 
library unit. 



offsite backup concept of storing backed-up data in a location outside of the 
building boimdaries or the EDM Backup server. 



offsite _0 \blumes that are located in the offsite Libraiy Manager 

(offsite_0) lepresenl those volumes that are located beyond the 
building's boundaries, such as an offsite ai'cliival location. A 
volume logically enters tlie offsite Libraiy Manager when you 
eject a volume from a libraiy unit or the offline Library Manager. 



optical disk Le.ss expensive storage medium that u.ses laser technology to 
read and write data. Two r^-pes of optical disks are: WORM 
(write once read many) disks and EO (erasable optical) disks. 



PC work item specifies the PC (NetWare, Windows NT. or OS2) or Open VMS 
client datti you want to back up. You can specify which direc- 
tories and files to include or exclude for backup. See also work 
item. 



periodic staging Scheduled filesystem staging mns that are set via crontab to 

return disk utilization to tlie low watermark. Periodic staging is 
another name for bulk .staging. 
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pop-up menu Menu that opens when you place the pointer over an object and 
click mouse button 3. 'Hie pointer changes lo an icon if a pop- 
up menu is available for that object. Pop-up menus appear in 
the browser of the Main window and tire Library Units and 
Diives area of the Library- Unit Manager windo%\'. 

port control Allows you to conti-ol the TCP ports used i^y ihe EDM to 

communicate wdth clients on the other side of a firewall. 



prestage reserve used for files that have been staged out, but also remain on the 
system's magnetic space, lliis magnetic space can be released 
quickly if disk utilization cross&s the IfWM. To allow filesy.stem 
usage to return to die LWM during a demand-staging event, the 
prestage reserx-e is typically the same size, or slighlh' larger, 
than the green zone. See also working set. 



prestage watermark {PSWM) Predefined level at which HSM begins to stage files out to 

secondary storage. The prestaged files still reside on magnetic 
disk. See also low watermark (1A¥M) and high watermark 
(HAX'M). 



prestaging Process in which files are written to secondary storage but their 
space on magnetic disk is not released. To minimize .staging 
delays, HSM anticipates staging requirements and prestages 
additional files to allow the magnetic filesy.stem utilization to be 
lowered quickly if the HWM is crossed or if a demand staging 
run is necessaiy. 



primary storage Main location, usually magnetic disk, for filesystem data storage. 

Magnetic disk storage is an example of primary storage and 
digital linear tape (DUT) is an example of secondaiy storage. 



EDM Software Reference 



15 



Glossary 



primary trailset Because of the alternate night scheduling feature, it is possible 
for each template fc; have hvo trailset^i. Therefore, even when 
you do not use alternate night scheduling and iliere is the only 
trailset, you will see it labeled Primary trailset. In addition, tlie 
name of die default trailset is "priman-". 

random setting Sample watermark setting intended for fiiesystems where reads 
outnumber writes, but where the access pattern is random and 
least-recently-used cacliing is ineffective. Tliis would be die 
case, for example, in a government records office, where 
several files must be read in from staging media in order to 
analyze a new file. When the analysis is completed, there is no 
need to keep the files on magnetic disk, because the files won't 
be accessed again for an undetermined period of time. You can 
select this setting for fiiesystems tliai match this random data 
access paltei'n. Odier sample watermark settings include, 
archive setting and cached setting. 

raw partition special file, located in /dev, that acts as pointer to a device 
driver. It associates a location, Vfpe, and access mode with a 
physical device. 

red zone Area on magnetic disk reseived for processes with root 

privilege. This area is used to expand system log files and other 
system files when the file.sy.stem is full. 'Ilie red zone only exists 
on systems that support minfree. 

Reliability Agent Scanner Daemon functionality' that actually monitors die EDM system; it includes 
(RASD) iIt^' rasd script and rasd configuration files. 

remote client software Software located on client which performs netw^ork backup of 
filesy,stems on die client. Windows .NT, NetWare, and OS/2 
backup client software must be installed on the client platlbrm. 
See also local client software. 
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Sofuvare that polls the rasd_a]ert file, notifying Customer 
Service Database when any significant events are detected. 



Report window Pan of the EDM graphical user interface that allows users to run 
reports on tlie local EDM or on many EDMs in a designated 
domain. Reports can be set to run autoinatically and can be sent 
to a printer, a file, or an e-mail addi'ess. Started from the EDM 
Main window. 



restore Copies a client's backup files from the iDackup seiver's media to 
the client's disk. See Restore window. 



Restore window Graphical user interface for restoring backed up data. Started by 
selecting Restore from the 1;DM window or tv'ping edmrestore 
on the ser\'e]-'s command line. Also for administrator use, it is 
not limited to usei-initiaied restore from clients of their own 
files back to their own client. If you have administrator permis- 
sions, you can also change destination directories and clients. 
See also cross-client restore and root restore. 



root restore Restore of any backup files or database information belonging 
to any user on the client to any directoiy on the same client. 
Suitable for a system admini.sli-ator of a single host. See also 
cross-client restore and seli'-service restore 



rotation period Backup configuration parameter in the schedule template. The 
period of days during which a full backup will be performed for 
each work item covered by a template (for automatic sched- 
uling). For custom scheduling, it's the schedule period. 
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saveset record Dam that is saved on backup media from a single backup of a 
single work item. A saveset record contains the template name, 
work item name, tlie backup level, stait and completion limes, 
expiration times, and the backup trail, llie saveset record is 
iLsed to find the volume containing the backup data and tlie 
a.s.sociaicd backup catalog. 

schedule in backup configuration, a template is set up to .specify the 
scheduling of backups and tlie use of media. See template. 

schedule period Backup configuration parameter in the template. It's the rotation 
period for automatic scheduling. Por custom scheduling, it's die 
numbei- of days in the custom schedule. See also testation period 
and custom sclieduling. 

secondary storage storage medium, .such as a Dl.T cartridge, u.sed as a backing 
store for the filesystem. See also primaiy .storage. 

self-service restore Uscr-initiated restore from UNIX clients of their own files back 
to their own client and directoiy. Sec also cross-client restore 
and root restore. 



server See l^ackup server or migration server. 



server software EDM Backup, Volume Management, and optional HSM software 
located on the EDM server. This software configures, initiates, 
and controls backups, restores, and ckita migration. See also 
remote client software and local client software. 

stage in Movement of data from secondary storage to magnetic disk. 

stage out Movement of data from magnetic disk to secondaiy storage. 
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Stageable RIesystem l-1lesysiem configured for migration. A stageable filesystem is 

^omelimes referred to as a "filesystem under migration control." 

stage-in daemon Process thai stages in files or deletes bilfiles when a staged file 
is modified. 

Staging hi HSM, the process of moving files h orn one level in the 

storage hierarchy to another; foi- example, from local storage to 
the EDM server or from magnetic di.sk to optical di.sk. Also 
referred to as migration. 



staging targets Destination for migrated daUi. Destinations include volumes, 
staging media, staging devices, and stores. 

staging template File that contains staging parameters for one or more 

filcsystems. Each filesystem is associated witli one staging 
template and each staging template can be u.sed by .several 
filcsystems. 



staging trail One or more volumes that contain staged data for a particular 
filesystem or group of filcsystems. Initially, a staging trail 
consists of one volume and gi'ows to several \'olumes to accom- 
modate the staged data. A staging trail and staging template 
share the same name. 



stale data Data that remains on optical disk or tape after the data is staged 
in to magnetic disk and modified. When a large number of files 
become .stale, the volume becomes a good candidate for 
compaction. 

store ID Unique code that identifies a client store on the network. 
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System Monitoring Support 
(SysMon) 



Software which conveys the Ixmctionality tliat provides system 
monitoring, including RASD (Reliabilicx- Agent Scanner Daemon; 
and RSM (Remote System Monitor). 



target ID Middle pan of a SCSI address (channel target ID. LIJN). larget 
IDs are numbered 0-7. 

template Also called baclcup schedule template, A set of specifications for 



scheduling backups and use of media. Each template is 
uniquely named and includes a list of work group names, the 
name of the trailset (which defines media use), and scheduling 
parameters, including die rotation peiiod for scheduling full 
backups, weekend backup policy, and weeknight liackup shift 
lengtlis. 

See also volume template. 



thrashing Unnecessary staging of files and movement of tlie autochanger 
in a library unit. 

trail Serial .set of volumes of a particular media type. I^ach trail of 

volumes is written to over the course of one rotation period and 
then a new set of volumes is started. The trail specification also 
defines how long to save the backup data and its associated 
online catalogs and records, Wliile uniqueness is provided by 
the combination of template, trailset, and trail names, it is 
helpful to give a unique name for each trailset instance, 

trailset Trail or set of trails to which the backup data is written, consti- 



tuting a complete set of full and incremental backups for a 
rotation period. While uniqueness is provided by the combi- 
nation of (schedule) template, trailset, and trail names, it is 
helpful to give a unique name for each trailset instance. Also 
called media set. 
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USername llsername on the client that is used by EDM Backup to execute 
the client software processing. (Tlie username is "ebadmin'' by 
default for all IJNYK filesystems.) 



volume Secondary storage media, such as tape cartridges, that contains 
a volume label and is entered into the volume catalog. 



volume catalog File that contains information about all removable media that is 
knoNA'n to the EDM server. Tlie volume catalog holds detailed 
information for each volume including a unique volume 
identifier, media characteristics, and the volume's current state. 



volume ID Unique identification number electronically assigned to even- 
piece of secondaiy storage media managed by the sei'ver. 



volume label Unique machine-readable code written on tlie backup media 
that includes a volume sequence rnimber, volume slale, volume 
ID, and volume name. All forms of removable media must be 
labeled before volume management can allocate them to an 
application. 



volume life cycle stages through which media (magnetic tapes and optical disks) 
pass in tlie EDM system. New media begins as unlabeled atid 
mo\'es to available (ready for general use foi- any trail) or 
allocated (ready for a particular trail only) depending on which 
template you choose during the labeling process. Other states 
include: foreign (non-EDM media), uncataloged (labeled on 
another EDM serx-er), erasing (optical disks only), and exjMred 
(no longer writable, just readable). 



volume management See ED.M \blume Management. 
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Volume Manager Cenlral volume management process witliin EDM software that 
manages all removable media known to an EDM server, llie 
Volume Matiager maintiins llie volume catalog and manages 
volume allocation, access, and volume life cycles. 

volume sequence number Unique identification number electronically assigned to every 
form of removable media managed by EDM Volume 
Management. 

volume state specific mode or phase in the media's life c\'cie. See also 
x'olume life cycle. 

volume template Named template that volume management uses for lateling 
volumes. See also volume label. 

watermark in HSM, preconfigured levels that divide a file-system into disk 
utilization zones. Watermarks are e.xpressed as percentages of 
total disk space. EI3M Migration has three watermarks: high 
watermark, Irjw watemiarl<, and prcstage watermark. Tlie 
watermarks define the yellow zone, green zone, and presiage 
reserve. 

There are three sample settings: archive setting, cached setting, 
and random setting. 

windOVlf manager Software tliat enables manipulation of windows. 

work group Set of wcjrk items that are to be backed up to tlie same set of 
media. Each work group is uniquely named and includes a list 
of like work items (fliat is, you cannot mix filesystem, PC, and 
database \vork items in the same work group). 
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work Item client resource that you want to back up. A resource can be a 
UNIX filesystem, data on a PC server, or an Oracle, Sybase, or 
Informix database. Each work item is uniquely named and 
specifies the filcsystems, database, or PC data to be backed up. 
You cannot mix filesystem, database, and PC work items in one 
work group. 

working set in HS.M, the .space on magnetic disk between the lAX'M and the 
non-siageable data. I'he working set represents the files that are 
accessed in a given period of time. 

WORM optical disk optical di,sk that does not allow data to be era.sed or rewritten. 

yellow zone Space on magnetic disk bet\veen 100% capacit>- and the HWM 
The yellow zone is reserved for processes to use while HSM 
brings filesystem usage back down to the LWM. 
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A 

Access Control IJst (ACL) 5-8 
activity checklist 1 3-33 
adding library units or devices 17-1 
allocation. See volumes 
akei-nate network backups 

online database 6-9 
alternate trailset 3-17, 19-5, B-13. B-59, B-70, B-75, 
B-85 

archival filesyslems 11-15 

arcliive life, of tape and optical media 11-20 

archiving EDM system logs 2-7 

ATL Storlink support 1-3 

authorized backup list B-5, B-18, B-19, B-37, B-52 
authorized recoveiy lists B-5, B-19, B-20 
autochanger C-17 

SCSI address C-1 8 
AUTOCONTIG 17-8 
autocoiifiguration 

client 3-7 
automatic scheduling 5-5, B-82 

alternate trailsets B-13, B-76 

backup shift B- 1 4, B-84 

computing B-74 

crontab 14-2 



forcing baselines to run first. See baseline 

backups, forcing bei'ore le\'els 0-9 
full during weekend rotiUions B-83 
initial client backup B-86 
level maps B-46 
load balancing B-43 

mutual exclusion willi eastern scheduling 
B-86 

options B-82 

rotation jieriods B-74 

setting up the initial backup B-15 

specifying a baseline witli B-11 

standard rotations B-14, B-83 

starting rotations B-73 

turning on B-14, B-83 

weekend rotations B-14 
automounted files 

timeouts 13-9 
autoscheduling 3-7, B-14 



backup 

automatic 14-4, B-4 
baseline reports 16-4 
checking completion of 2-3 
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backup (conlinued) 

client home directory A- 13 

coordinating with stageoiit schedules 13-4 

crontab 14-4, B-4 

executing 14-4, B-4 

filesystem 5-7 

high priority 8-11 

incremental 5-7 

insKiIlation files A^2 

nightly 14-4, B-4 

processing 14-2 

queries 16-3 

reports 3-21 

See also reports 

reuse of baseline volumes 12-18 

schedule 11-22, B-82 

starting 14-4, B-4 
backup account B-5, B-17 
Backup Activity? \X'izard 1-15, 3-5, 5-5, 14-2 
back up admin istra tor 

recovering files B-19 

recoveiy administrator B-23 

user names B-5, B-17, B-79 
backup catalogs 14-9 

changing a filesystem B-3(), B-35, B-49 

changing a woi'k item B-30, B-35, B-49 

compressing B-1 1 , B-58, B-69 

creitting 3-11 

deleting incomplete 2-8 

delta level B-11 

disinbuting among several disks 10-10 

expii-ation period 3-12 

expiring 3-12, 10-4, B-66. B-67, B-6S 

locating during recovery B-68 

processing of 20-31 

recTcating 10-2 

retention period B-11, B-68 

setting processing schedule 14-9 
backup client cleanup command B-9 
backup client directories A-13 



backup client initialization command B-9 
backup clients B-5 

backing up 5-5 
backup completion reports B-1 3, B-71, B-79 

locale failure information B-80 
backup completion script B-79 
backup configuration file B-1 to B-87 

backup template fields B-70 

editing rules B-3 

field summary B-5 

findxcpio macros D-3 

server B-5 

server bkx-k fields B-1 6 

server-level configuration fields B-5 

specifying backup files D-7 

trailsel fields B-5S 

Vs'ork item fields B-32 
Backup Configuration window 1-17, 3-13, B-1 
Backup Configuration Wizard 3-13, 14-2 
backu]5 coverage reports 16-32 
backup data B-70 

definition of 3-20 

expiring B-65, B-66, B-67 

locating during recovery B-68 

retention period B-65 

storage of 3-11, 5-12 
backup databases 

when to back up 2-10, 13-7 
backup duplicate reports 16-12 
backup expiration 5-19, 5-20 
backup failure reports B-13, B-80 
backup failure script B-80 

backup levels 1 1-34, B-7, B-8, B-10, B-34, B-38, B-45 
alternating trailsets B-76 
autoscheduling 3-7 

baseline level written to a trailset B-11, B-64 
consolidating catalogs B-ll, B-69 
custom schedule in eb.cfg B-1 5, B-82 
custom scheduling B-82 
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forcing baselines lo nin first B-13, B-43, B-70, 

B-80 to B-8] 
forcing level 0 B-30, B-35, B-49 
full 3-7, 3-9, 3-11 
incremenial 3-7, 3-11, 5-5 
load balancing B-7, B-43, B-54 
mapping B-8, B-45, B-56 
retaining l.:)ackup catalogs B-68 
retaining saveset records B-ll, B-69 
specification in eb.cfg B-84 
specification of the filespec B-37, B-52 
specifying B-6l 

specifying the filespec for le\'els B1 and B2 
B-7, B-38 

lime between full backups B-12, B-74 
trails B-n 

work item options by B-34 

writing a trail B-5S, B-60 
backup path 

vei'SLis restore patli 5-16 
backup prioiity B-7 
Backup Report window 16-1 
backup i-eports 16-1 

See also reports 
backup saveset 3-20 

backup catalog 3-20 

backup data 3-20 

saveset records 3-20 
backup schedule B-35, B-42. B-72 

specification in eb.cfg B-82 
liackup server 

backing up all filesystems B-38 

backing up database files B-42 

database f^les B-46 

directories A-2 

maximum simultaneous client backups B-5, 

B-60, B-62 
name B-5 

priorities and resources B-42 
software files A-2 



backup ser\'er log file. See template log files 
backup shifts B-31 

definition B-84 

nightly 3-10 

weekday goal B-14, B-82, B-84 

weekend goal B-14, B-82, B-S4 
backup templates B-59 

backing up wc:irk groups B-31 

backup completion reports B-79 

efficiency widi fev.''er B-60 

forcing baselines first B-43 

list of fields B-12 

mapping levels B-8, B-i5, B-56 

naming B-12, B-71 

obsolete work items B-35 

removing oKsolete B-72 

specification in eb.cfg B-70, B-84 
backup trailseis 3-3 
backup work groups 3-3 
backup/ HSM Utg 11-9, B-34, B-39 
backupdates file 11-9 
backups 14-5 

automatic. See nightly backup processing 

Backup Activit)' Wizard 3-5, 5-5, 14-2 

baseline work items 16-27 

command-line 14-7 

configuration window 3-13, B-1 

configuration wizjuxl 3-13, 14-2 

coverage reports 16-32 

database 2-10 

deleting expired catalogs and media 2-8 
deleting incomplete catalogs 2-8 
disabling client backups B-19 
executing fi-om crontab. See nightly backup 

processing 
expiring 5-19, 5-20, 10-3 
expiring catalogs B-68 
expiring data B-66, B-67 
expiring saveset records B-68 
from crontab 14-5, B-42 



EDM Software Reference 



Index 



backups (coniinued) 

histoiy 

work items 16-16 

interleaving on media 5-12 

load balancing 3-7 

local client 5-2 

log files. See log files 

manual 3-22, 14-7 

modified files 3-1 1 

network 16-37 

NFS timeouts D-10 

nighriy processing 3-10 

online 5-7 

priority 5-4, 5-5 

rotation period 3-7 

scheduling 3-3. B-41 

automatic. See autoscheduling 
custom. See custom scheduling 
!rom command line B-1 

storing 3-11, 5-12 

verifying backups 2-S 
backups.log files 5-15, l6-5, 16-35, B-27, B-28 

client B-6 

server B-6 
barcode 

configuration C-15 

inventory 8-21 
ba.seline 

backups 

updating the saveset-to-baseline 
relations databa.se with A- 10 

media 11-29 

reports. See reports 
ba.seline backups 

active volumes 12-19 

as backup levels. See backup levels 

completeness option with B-R, B-34, B-45 

custom scheduling B-85 

definition 11-33 

expiring saveset records for B-69 



filespec lorB-7, B-34, B-38 

forcing before levels 0-9 B-13, B-43, B-70, B-80 to 
B-Sl 

level mapping, and B-47 
level written for a irailset B-ll, B-64 
recreating automatically B-14, B-71, B-81 
trails used foi- B-60 

updating the savesct-to-baseline relations 
database with 5-3 

with stage-to-tape 11-21 
baseline filespec B-34 

how to speciiy B-38 
baseline volumes 

deallocating 5-20 
baseline-relative lockups 5-20 
bitfiles 12-13, A-24 

l6-digil hexadecimal name 12-13, A-24 

bitfile ID 12-13, A-25 

description of 11-7 

names 12-13, A-25 

stale 11-30, 13-30 
buckets 1 2-7 
bulk staging 11-2 

automating 13-2 

stage in 13-9 
byte array. See bitfiles 



cached filesysiems 11-15 

candidate list 11-19, 12-5 

catalog disk subsystem 1-9 

catalogs 3-11 

backup. See backup catalogs 
distributing among several disks 10-10 
expiring 10-3 

expiring backups 3-12, 10-3 
processing 20-30 
recreating backup 10-2 
status of processing 16-9 
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volume 7--1 A-20 

vokime template A-20 
checklist for port control 4-10 
circular log files 15-4, A-19 
cleaning caitridges 

default barcode 8-K) 

injecting into library units 8-10 

maximum usage count 8-10 

usage count 8-11 
cleaning tape drives 2-9 
client account B-5, B-17 
client agent. See emsd 
client backup usernamc R-5, B-17 
client directories A- 13 
client log files 16-37 
client pacing 5-1 1 
client recoveries 

authorizing B-5, B-19, B-20, B-23 
client relations B-12, B-74 
client software 3-2, 5-6 
client stores 11-4, 11-6 

bilfiles 12-13, A-24 

changing name of 13-16 

changing ownership of 13-16 

clearing incomplete bitfiles 2-9, 13-31 

creating 13-32 

director)? tree 12-12, A-23 

future needs 11-9 

how many to create 11-7 

ownership 11-7 

removing 13-32 

when to back up 13-7 
clienL/'sen'er architecture 3-2 
clients 

-ebadmin login A- 13 

autoconfiguring 3-7 

backing up 3-1 1 , 5-5 

backing up filesystems 3-6 

backup installation A- 13 

client pacing 5-10, 5-11 



database 5-4 
di.sabling backups B-19 
IBM ACLs 5-9 
local backup 5-2 

maximum simultaneous backups B-5, B-24, 
B-62 

maximum simultaneous backups pes' ti'ail 

B-]l,B-60 
multiple networked B-40 
NetAX'are 5-4 
new 

scheduling first backup B-15 
NFS filesystems D-10 
platforms A-6 
restoring data 3-12 
imavailable during backup 5-5 
work groups. See work groups 
work items. See work items 
command-line interface 14-7, 18-1 

See also scripts, manpages 
command-line scheduling B-65 
commands 
backup 

eb_server_config B-17 
ebbackup 2-8, B-4, B-17, B-41, B-71, B-81 
ebimport 10-14 
ebrestore 5-16, B-24, B-28 
findxcpio 5-7, B-7, B-8, B-10 
startfind 5-4. 5-7 
recover 

ebrestore B-20, B-22 
lindxcpio B-37 
restore 

edmrestore 5-18 
compaction 13-6 

administering 11-28, 13-29 

baseline 11-29, 1.3-30 

baseline volumes 12-18 

coordinating with backup and USM 13-5 

dbreport 13-19 
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compaction (conlinucdj 

descriprion of 2-6, 11-27 

disabling 13-26 

emxattr file 11-27 

goals 12-14 

limits 13-7 

manual 11-27, 13-28 

report 11-30 
completeness option 5-5, B-7, B-34, B-45 

defining 11-34, 13-44 

staged files, with B-43 

with baseline-relative backups B-45 
completion reports 16-4, 16-29 

See also backup completion I'eports 
concise log 15-3 

conf_ism_staging_template. See emstconf 

configuration 

autochanger C-1? 
barcode C-1 5 
client 3-7 

database (HSM) 12-2, A-21 
default backup 3-7 
default trail 3-7 

ElDiVl Symmetrix Connect 6-15 
logical unit number C-1 7 
of Libraiy Managers 17-1 to 17-14 
watermarks 1 1-10 
configuration files 
backup B-1 to B-87 

See also backup configuration file 
eb.cfg A-8 

IJbrary Manager C-9 
Im.cfg A-19 

.server block fields B-1 6 
syslog 15-6 
Volume Manager C-2 
work group fields B-31 
connection 

connection via B-7, B-40 

use connection metiiod B-9, B-57 



convenient property 13-10, 13-24 

stageout 11-23 
ccjordinating HSM and backup 11-22, 13-5 
coverage reports 16-3, 16-32 
crash files 

deleting 1 0-4 
creating 

space on magnetic disks 10-13 
cron 2-6, 13-31 

autocompaciion 12-15 

backup process 3-10 

message logging system 2-4 

periodic staging 11-22 

See also command-line backups, cronlab, nightly 
backup processing 
crontab 14-5, 16-26 

adding entries from tlie EDM GUI 2-6, 14-4 

backup 14-4, B-1, B-4, B-38, B-42 

backup catalogs 14-10 

file 14-4, 20-5, 21-2 

message logging system 15-2 

nightly backup 14-2 

reports 1 6-1 
crontab file 

deleting existing entries 2-9 
cross recovery B-5, B-20 
current suiging volume 11-4, 13-19 
custom schedule 3-17 
custom scheduling B-65 

akemate trailsets B-76. B-77 

establishing the sciiedule B-1 5, B-84 

exec\iting backups 14-6 

forcing baselines to nan first. See baseline 

liackups, foi'cing tefore levels 0-9 
level maps B-4 6 

mutual exclusion witli automatic scheduling B-86 
options B-82 

rotation periods B-74, B-86 
starting rotations B-73 
turning on B-1 5, B-84 
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D 

daemon processes 12-9 
daemons 

ebbackupd 14-9 

ebcatalogd 5-3 

Library iManager 8-4, A-19 

notd 8-4 

Volume Manager 8-4, C-5 
daily log 

distribution list 2-4 

syslog 15-3 
daily ta.sks 2-2 

damaged disk, replacing 21-1 
database 

backup levels B-47 

EDM .Symmetrix Connect clients 6-6, 6-7 

EDM Symmetrix Path 6-2, 6-12 

EDM Symmetrix Path clients 6-3, 6-6, 6-7 

files 2-10 

network 6-2 

online nem-ork 6-2 

otiline nenvork clients 6-3, 6-6, 6-7 
database backups 6-2 

backing up client 3-11 

restoj-ing 5-18 
dbreport 11-27, 11-30, 13-19. 13-28, 16-34 

compaction repoit 13-7 
deadlock potential 

with stage-to-tape 11-21 
debug logging level 15-3, B-77 
debug mode 

volume management C-6 
deconfiguring a Libraiy Manager 17-14 
default cleaner barcode 8-10 
default configuration 

backup 3-7 

trails 3-7 
defauli_template.log file 16-36 
delay factor 1 1 -22 



deleting expired catalogs, media, and savcset 

records 2-8 
delta catalog 10-8 
delta inventory 8-21 

delta level. See backup catalogs, cc^mpressing 
demand stageout 11-2, 11-12 
detail log 15-3 
device drivers 
adding 17-1 
instill ling 17-1 
removing 17-7 
updating 17-6 
device node C-17, C-18 
df 13-18 
directories 

backing up client 3-11 
client A- 13 

-ebadmin A-13 
bin A-16 
ER A-15 
EB_DB A-16 
home A-13 
man A-16 
HSM A-21 



bin A-5 

catalogs A-5 

client A-6 

configA-8 

db A-9 

locks A- 10 

man A-10 

preconfig A-10 
V.M A-2 
disabling staging 13-24 
disaster recoveiy 20-1 to 20-33 
an example 20-2 
client restore 21-1 to 21-6 
disabling backup commands 20-5, 21-2 
liardware 20-6 
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disaster recoveiy (conlinued) 
MSM local coiifiguration 20-18 
libi'an- manager configuration 20-11 
preparation for 19-1 to 19-6 
restore LOCAL_DATABASE 20-15 to 20-22 
software 20-6 
strategy 19-2 

using duplicate volumes 20-21, 20-23 
disaster reports 2-5, 16-4, 16-19 to 16-26, 19-'i 

disk configuration 20-7 

inslallaiion report 20-9 to 20-11 

vfstata 20-8 
disconnecting libraiy units 17-14 
disk capacity 

monitoring 1 0-5 
disk crash 

client recovery 21-2 
disk thrashing B-81 

disk thrashing, pi'eventing. See exclusion tags 
disks 

backing up magnetic 3-10 

capacity 10-5 
Dl.T media 8-27, C-18 
do not load balance field B-7, B-34, B-43, 
B-54 

drive cleaning 8-22 
drive preemption 8-1 6 
drives 

busy 8-11 

contents file A-19 

preempting 8-16 

scheduling 8-16 

SCSI address C-18 

See also tape drives 
D'lT 8-27 

duplicite command options 16-13 
duplic-ate volume sequence numbers 8-26 
duplicate volume states 9-28 
duplicate volumes 7-5 

in disaster recover)' 20-23 



duplication state 16-12 
duplication status 16-12 

E 

eb_servei-_config 5-14, 20- 11, 20-13, B-17 
ebadmin client backup user name B-5, B-17 
ebadmin login A- 13 

ebbackup 2-8, 5-3, 5-4, 5-13, 5-14, 10-3, 13-7, 14-7 

21-2, B-4, B-17, B-41, B-71, B-81 
ebbackupd 5-3, 5-4, 5-12, 5-14, 5-15 
ebcatalogd 5-3, 5-13, 14-9, 20-16, 20-22 
ebcatclean 2-8, 21-2 
ebcat.log file 16-5, 16-36 
ebcatproc 20-31 
eb.cfg file A-8 

backup. See backup configuration file 
ebcp 13-14 to 13-18, 13-27, 13-32 
ebcrecover 5-17, 18-3 
ebexpire 2-8, 10-4, 10-14, 12-19, 21-2 
ebfs_import 13-15 
ebimport 3-21, 10-14, 20-16 
ebrecover 5-17, 18-3 
ebreport 9-25, 10-8, 16-4 to 16-35 

backup 16-6 to l6-9 

baseline 16-27 to 16-29 

coverage 16-32 

disa,ster 2-5, 16-19 to 16-26, 19-4 
2-8 

duplicate 16-12 

histoiy 2-3, 2-8, 10-11, 16-15 to 16-18 
media 2-8, 16-10 to 16-11 
run from cron 2-8 
ebreport coverage 1 6-32 

ebreport duplicate 9-25, 9-27, 16-12, 16-13, 16-1- 
ebreport history command options I6-I6 
ebreport media 9-25. 9-29, If)- 10 
ebrestore 5-13, 5-l6, 13-34, 13-35, 13-36, 14-9, 16- 

18-2, 18-3, 18-5, 20-19, 20-28, 20-29, 20-30, 

20-31, B-20, B-22, B-24, B-28 
ebsen-er field B-5, B-17 
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EDM 

grapWcal user interlace (GUI) 1-12 

hardware 1-9 

internal components 1-9 

oven-'iew 1-3 

sofnvare 1-11 
EDM LibraiT Unit Manager 7-3 
EDM Migration 

determining backup status for clients 5-3 
EDM Migration clients 

completeness option with B-34 

work-itcyn options for B-3''i 
EDM Symmetrix Connect 1-6 
EDM Symmetrix Patli 1-5, 6-2, 6-12 
cdm_scrvices 

files 4-14 
edmcrestore 3-12, 5-17 
edmproc 8-5, 8-7 
edmremote 1-13 
etn_make_cl 1 2-4 to 1 2-6 
embsl 11-2, 12-7, 13-9 
emcheck 11-31, 13-12, 13-33 
emchmod 11-23, 11-25, 11-26, 12-7, 13-10, 13-24 
emcompact 2-7, 11-27, 12-14, 13-5, 13-28, 16-35 
emdu 13-18 
emfmd 12-7 

emfsconf 11-22, 12-2, A-21 

emfsreport 13-19, 13-20 to 13-22, 13-26 

emls 11-23, 11-24, 12-7, 13-2, 13-10. 13-18 

emlsconf 20 17 

emmasterd 1 2-4 to 1 2-5 

emscheck 2-9, 13-31 

emschs 13-16, 13-31 

emsd 12-9 

emsid 12-7 

emsmks 13-32 

emsmvs 13-16 

emsstat 11-31, 13-32 

emstage 11-2, 12-7, 13-2, 13-9 

emstconf 1 2-2, A-21 



emsundel 2-9 
emsysconf 12-2, A-21 
emvck2-7, 11-28, 13-5, 13-6, 13-29 
emxattr file 11-27 
epcleanup 2-8, 10-4, 10-15 
epnewlog 2-7 

Epoch Bitfile System (EBFS) 8-3 

Epocli Volume Management. See volume 

management 
eptrunclog 2-7 

erasable optical (EO) media 8-27, C-18 
erasing, volume state 7-7 
error logs, rotating 1 3-8 
error messages 1 5- 1 

format 15-5 

logging level B-77 
evmclivol 8-11 
evmclean 2-9, 8-22 
evmimport 8-9 
evminject 8-1 0 
evminventon' 20-1 9 
evmlistd 8-3, 8-26 
evmstartiip 20-22 
evmstat 8-3 

exclusion lags 5-5, B-7, B-34, B-40, B-53 
expiration 3-20 

backup 5-19, 5-20 

backup catalogs 3-12. 10-4, 10-14 
expired media 7-6 
expiring backups 10-3 

F 

failed backups, reprocessing 14-7 
failed duplications 9-19 

removing from the queue 9-18 

vmdup -remove 9-18 
failure reports 16-2, l6-4, 16-31 

See also backup lailure reports 
features 

EDM Symmetrix Connect 1-7 
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fcnceposi 11-24, 12-6 

file control properties 11-23, 13-10 

listing and changing 11-24 
file locking 11-23. 11-24, 13-12 
file names 

/usr/epoch/man A-1 3 

/usi'/man A-1 3 

-ebadmin A-13 

~ebadmin/c//c-'»/-;/a;Hi?/l:)in A-1 3 

~ebadmin/c//(?«/-«(37?;e/l liSTORY A-1 3 
file properties 

•Staging control 11-23 
file recoveiy 3-12, 5-16, B-16 

catalogs B-68 

commands. See commands, fccover 
completeness cjptions, and 11-35, B-3'-f, 
B-45 

enabling B-5. B-19. B-20. B-23 
logging B-28, B-29 

recovering another client's files. See cross 
recovery 

time vs. rotations B-74 

using a baseline for B-14, B-81 
file i-ecoveiy commands 

ebrestore B-24, B-28 
file serial numbers. See i nodes 
files 

automoLinled 13-9 

backing up client 3-11 

backing up modified 3-11 

circular log A-1 9 

daily changes 10-7 

deleting tmp and crash 10-4 

determining number of backed up 10-9 

drive content file A-1 9 

eb_ci_dala A-7 

eb_ci_particulars A-7 

eb.cfg A-8, B-1 to B-87 

excluding from backup D-S 

Library Manager configuration VA) 



Im.clg A-19 
log 15-2, 15-4 
recovering 5-1 6 
recovering client 3-12 
scanning client 5-7 
specifying for backup D-7 
specifying with findxcpio D-7 
staging control properties 11-23 
volid.dat A-19, C~15 
volume management A-1 8 
Volume Manager configuration C-2 
filespec B-8, B-34 

specifying B-37, B-52 

to back up B-37 
filesy.stem delay 1 1 -22 
filesystems 

archival u,se 11-15. 13-20 

backing up client 3-6, 3-1 1 

cached 11-15 

cleaning up 1 0-4 

delaying stageout 11-22 

exceeding HWM 11-12 

exceeding PSWM 11-11 

general purpose use 1 1-1 5 

limits 11-18 

populating 13-23 

random use 11-16 

satnning 5-7 

with many small files 11-19 
findxcpio 5-3, 5-7, B-7, B-8, B-10. B-37 
findxcpio macros D-3 
firewall 4-5 
Flags column 11-24 
foreign volumes 7-6 
fi eezing a client store 13-31 
full backups 3-7, 3-9, 3-11, B-63 

avoiding extra B-7, B-43, B-54 

performing initial B-1 5, B-86 

rotations B-1 2, B-74 
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uncompressed catalogs B-70 

week or weekend B-14 
llill filesystems ll-IO, 13-19 
fuser 1 5-4 

G 

graphical user interlace CGU]) 1-14 

H 

hardcopy documentation xxxi 

hardware 

configurations 6-15 
replace after a disaster 20-6 
SCSI address 17-^i 

hardware address configuration C-18 

high watermark 11-2, 11-18, 13-25 

history reports l6-4, 16-15 to 16-18 

HITC 8-27 

HSiV] 

activity? checklist 2-2 

client installation 1-21 

Configuration window 1-22 

disabling 13-25 

performance factors 11-5 

procedures am via cron 2-6 

staging to tape 13-3 

support 1-8 

volume labels 7-8 
HSM backup tags A-10 
HSM directories A-21 



I/O daemon (iod) 

circular log file 15-4 
importing volumes 8-9 

importing duplicate volumes 8-9 

media information 8-10 
incremental 5-7 



incremental backups 3-7, 3-9, 3-1 1, 5-5, 5-7 
expiring catalogs B-68 
mapping B-48 

maximum concurrent clients B-63 

week day B-B3 
inheritable propenies 11-23, 11-25 
initiating manual duplication 9-8 
inject 8-11 

injecting cleaning cartridges 8-10 
inlet configuration C-15 
inlet types 

automatic 8-8 

manual 8-8 
inodes 11-19 

information about 13-18 
Install Wizard 1-15 
installation repon 20-9 
interfaces 1-13 

recoveiy 20-22 
interleaving backups 5-12 
inventories 

delta 8-21 

library unit 8-20 
in\'entory methods 

verify barcode 8-21 

verify label and barcode 8-21 
inventcjiy table 8-19 
ism_compact command 21-2 

K 

keep Imckup catalogs B-68 

keep backup catalc:)gs specification 10-3 

vs. rowtion period 10-5 
keep backups specification 10-3, B-ll, B-65 
keep propeity 11-23 

keep saveset records specification B-ll, B-68 

kernel messages 15-5 

key processing concepts 3-3 
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L 

labels 

volume 7-4, 8-12 
level 0 backups. See full backups 
level 9 backup. See incremental backups 
level map B-8. B-34 

precedence over schedule block fields 
B-83 

specifying B-45, Bo6 
le\'els. See backu]^ levels 
Library Managers 

circular log file 15-4 

configuration files C-9 

daemon 8-4, A-19 

deconfiguring 17-14 

drive preemption 8-16 

icon 7-12 

initial startup 7-13, 8-19 

listing configured 17-3 

names 17-3, C-1 5 

naming conN-eniion C-9 

offline 7-13, C-19 

offsite7-13, C-19 

reconfiguring 17-1 

simultaneous backup example 8-17 

subdirectories A-18, C-10 

verifying priojity 8-1 6 
Librar>' Unit Manager window 1-16 
library units 

adding 17-1 

automatic inlet 8-8 

barcode suppoii C-1 5 

contents of A-19 

deconfiguring 17-14 

drive address C-18 

drive content file A-19 

dri\'-e preemption 8-16 

drive scheduling 7-13, 8-16 

ejecting volumes 7-14 

inlet configuration C-1 5 



inventoiy 8-18. 8-20. A-19 
list 7-13 

operations 8-1 

SCSI address C-17 

slot contents C-1 5 
life cycle management 7-4 
limit throughput field B-6, B-25 
LVl_lNLET_IGNORE_ON_OPEN C-19 
LM_MAX_RESIDEN'r_TlME 8-17 
Ul_MIN_RESIDENTjr]ME 8-17 
Im.cfg file A-19 

linconlig8-4, 17-1 to 17-17, 20-1], C-1 

AU1X3CONF1G 17-8 

troubleshooting 17-17 
load balancing 13-6 

excluding a work item from B-34 

excluding work items B-7, 15-43, B-54 
local account 

backup client user name B-5, B-17 
local client B-32 

backing up 5-2, B-38 

connecting to ilie seiver 5-4 

level map for database files B-46 

log files 16-37 

priority for darafjase files B-42 

using the migration backup tag on B-38 

work-item options B-34 
LOCAL_DA'rABASE 20-2 to 20-3 

backup 19-3, 20-15 to 20-22 

late backup 2-10 

priority 2-10, B-42 

restoi-e 20-1 5 to 20-22 
locked property 11-23, 11-24, 13-12 

performance factors 11-24 
locking files 13-11 
log files 3-20, 16-5, 16-35 to 16-37 

backup 5-15 

backup template 1 6-36 

backups.log 16-5, 16-35 

circular 15-4, A-19 
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client 16-37 
ebcflt.log 16-5, 16-36 
expiring 10-4 
expiring oldest data B-27 
mntl'aull 1 5-3 
recoA'eries.log 16-5, 16-35 
server log file l6-5 
syslog 15-3 

template_name 16-5, 16-36 

volume management 15-1 

See also I'epojts 
l(jg message format 15-5 
logging level 16-36, B-13, R-77 

debug 16-36 

per file 16-36 

stats 16-36 
logical unit numtx-'r C-17 

autochanger C-17 

in SCSI address 17-4 
low watermark 11-2, 11-10 to 11-18, 11-22, 13-19 

M 

magnetic disks 

backing up 3-10 

capacity 10-5 

creating space on 10-13 

utilization of space 13-23 
magnetic t:tpe drive. See drives, tape drives 
magnetic tapes 

backup 3-7 
mailerr script 5-15, B-13, B-80 
mailing the daily log file 2-4 
mailok script B-13, B-79, B-80 
manpages 18-1, A-10, A-l6 

backup and restore 18-2 

HSM 18-9 

migration 18-9 

volume management 18-6 
manual backups. See command line interface 
manual operations 3-22 



inapping backup le\'cLs. See backup levels, 

mapping 
master staging daemon 12-5 
maximum simultaneous clients B-5, B-24, B-60, 

B-62 
media 

allocating volumes B-76 
backup levels B-11, B-60, B-6] 
choices 11-19 
conserving B-75 
designated by a trail B-60 
DLT 8-27 
ejecting 8-14 
erasable optical 8-27 
expired 7-6 

expiring B-66, B-67, B-68 
importing volumes 10-13 
inserting into library units 8-8 
management B-61 

maximum trails per media type B-6, B-24 
maximutn uses 18-6 
reports 16-10 to 16-11 
retention B-11, B-65, B-67 
reusing B-65, B-67 
rotations 16-10 
tracking B-61 
trailsets B-58, B-60 
transferability 11-22 
using trailsets B-11 
WORM 7-11, 8-27 
See also volumes 
media duplication 3-18, 9-1, 9-31, 19-5 
append mode 9-5 
automatic 9-8 

backup duplicate report 16-14 
baclcLip or restore 9-2 
canceling 9-17 

concurrent duplications 9-11, 9-24 
Control window 9-20 
detennining duplicates 9-24 
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media duplication (continued) 

disabling 9-15 

duplication state ]6-12 

duplication stauis 16-12 

Duplications window 9-30 

ebreport duplicate 9-27 

ebreport media 9-10 

evmstat 9-]] 

failed 9-20, 9-29 

importing a duplicate 9-29 

initiating 9-8 

manual 9-2, 9-8 

manually disabling 9-14 

media list 9-10 

mode 16-12 

new mode 9-5, 9-6 

offline volume 9-14 

padding block 9-4 

pausing 9-16 

process 9-2 

reenabling 9-14, 9-15 

reject mount request 9-29 

rescheduling 9-19, 9-25 

rescheduling a single volume 9-14 

rescheduling an offline volume 9-22 

resuming 9-17 

verifying status 9-10 

vmdup 9-3, 9-8 

vmdupcfg 9-3. 9-4, 9-12, 9-1 5 

vmdupd 9-3, 9-9, 9-13, 9-16, 9- J 8 
media rotation 

starting new B-74 
media t>'pes C-18 
media wear 

with stage-toiape 11-21 
message logging system 15-1 

default configuration file 15-6 

features 1 5-2 

rotating, archiving log files 13-8 
message number 1 5-5 



migration volumes 

verifying information on 13-6 
migration, disabling 13-25 
mntfault log 15-3 
monitor 

active backups 3-22, 16-3 
monitoring magnetic disk space 10-10 
multiple networked clients B-40 
multiplexed storage 3-13 

N 

names 

backup account B-5, B-17 
naming conventions 

Library Manager C-9 
NetWare' 

work items 

fields in configuration file B-9 
network 

database \'endors 6-3 

limiting the available bandwidth B-25 

multiple networked clients B-40 

scn'er login name B-17 
network backup of filesystems 16-37 
netv>'ork clients 

moving files ber^'cen 13-16 

work item options B-34 
netw(3rk database 12-10 
network database (1 ISM) A-22 
network migi'ation server 12-9 
NFS timeouts D-10 
nightly backup pi'ocessing 3-10 
NIS password map B-17 
non-niirrored configuration 6-17 
non-stageable filesystems 13-19 
notih' daemon (notd) 8-4 
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0 

offline 

Library Manager 7-14, C-19 
oJTsite 

Library Manager 7-14, 019 

media 19-5 

storage 

alternate Irailsets, ofB-TO 
online 

backu]')s 5-7 

books 1-12 

catalogs 3-1 1 

database backups 6-7 

help 1-12 
online documentation xxx 
online help xxx 
optical disks 

compacting 11-27 

P 

paddijig blocks 9-4, 16-12 

pass count, of tape and optic-al media 11-20 

performance factors 11-5, 11-19, 11-24, 11-31. 13-6 

performing full backups B-15, 13-86 

periodic stage out 11-2, 11-22 

automating 13-2 

coordinating with backup 13-5 
permissions 3-19 

backup and recovery B-5, B-17 

recoveiy 

root permissions B-5 
pid, See process ID 
port control 4-1 

checklist 4-10 

clients 4-1 S 

default port ranges 4-6 
files 4-14 
firewall 4-5 
making changes 4-20 



restrictions 4-''i 

the portservices CLl 4-3 
portservnces files 4-14 
pre.stage 11-2, 13-9 

description of 11-10 

policy 11-15 

reserve 11-13 to 11-15 

watermark 11-10 to 11-15 
preventing stage outs 13-11 
primaiy trailsei 3-17, 19-5. B-13, B-59. B-70. 

B-75 
pi-iority B-34 

backup 2-10, 5-5, B-7, B-43 

controlling backup 5-4 

settings B-4 2 

work item B-41, B-54 
process ID 

in log messages 15-5 
processes 

Library Manager 8-4 

Volume Manager (vmdaemon) 8-4 
product description 1-7 
PROM level 17-5 

R 

random filesystems 11-16 
reaftiiching staged-out files 13-15 
reconfiguratic^n reboot 17-5 
recover 

administrator ILsi B-5, B-23 

client data 3-12 

di.sabling B-20 
recoveries.log file 5-15, l6-5, 16-36, B-6, B-29 
recovering bitfiles 2-9 
recoveiy 

disaster 19-1, 20-1, 21-1 

log files 5-15 
recreating a baseline automatically B-14, B-71, 
B-81 

recreating backup catalogs 3-21, 10-2 
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remote diagnostic modem 1-10 
remote GUI launch 1-13 
removing 

librai7 units 17-14 
unnecessary files 10-15 
replacing a damaged disk 21-1 
Report window 1-18 
reports 16-1 to 16-34 
backup 2-3, l6-4, l6-> 
baseline l6-4, 16-27 
completion 16-4, 16-29 
coverage l6-3, 16-4, 16-32 
lai]ure*l6-2, 16-31 
histoiy 16-4, 16-15 to 16-18 
media 9-25, 16-10, 16-11 
backup completion 5-14 
backup failure 5-15 
backups.log 5-15 
disaster l6-4, 16-19 to 16-26, 19-4 
file.sysiems not backed up 16-3 
HSM 11-30 
in crontab 16-1 
installation 20-9 
online 3-22, 16-3 
recoveries, log 5-15 
volumes 16-34 
See also ebreport, log files 
reserved files in VxFS 13-12 
residence priority' 11-23, 11-25, 12-6, 13-11 
resident files 

backing up B-8, B-32, B-34 
; 11-33, 13-13 



cross-client 5-9 
database backups 5-18 
files with ACLs 5-9 
how it works 5-l6 
server disaster 20-1 
restore modes 3-20 



restore path 

vt=;rsus backup path 5-1 6 
Restore window 1-19 
restoring client data 3-12 
Restricted by Application 8-25 
restricted volume template 7-8 
resDlcted volumes 11-4 
revision levels 

(3racle 6-7 
robot 7-13 

robot. See autochanger 
rotating EDM system logs 2-7 
rotation period 19-5 

14 day B-12,B-75 

28 day B-75 

7 day R-74 

alternating trailsets B-76, B-77, B-85 

autoscheduled 3-7 

custom scheduling B-1 5, B-86 

default B-74 

definition 3-15 

initial backup B-15, B-87 

load balancing B-43 

media B-76 

specifying B-12, B-70, B-74 

vs. keep catalogs period 10-5 
rotation schemes 

full backups during weekend rotations B-82, B-83 

standard B-82, B-83 
Ri^C 

HSM protocol 12-8 
rvmoper 8-1 



saveset records 
definition of 3-20 
expiring 10-3, B-66, B-6S 
online 10-2 

retention period B-ll, B-68 
SBus cards 1-9 
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sclieduling 

aiiiomatic 3-4, 5-7, 14-6 

backup 3-3, 14-2, B-82 

catalog processing 14-9 

command line 3-5 

custom 3-^1 3-17, 14-6 

nightly start of backups 14-3 
scheduling backups B-14, B-^il, B-42, B-46, 
B-72 

alternating trailsets B-76 

work groups B-31 
scheduling level 0 backup B-35 
scripts 

epcleanup 10-4 

lindxcpio 3-7 

Imconfig 17-1 to 17-17 

startfind 5-4 
SCSI 

address 17-4, C-17, C-18 

bus slot C-17 
selMescribing media 11-22 
sen-er 

concurrent client backups 3-6 

database (HSM) A-22 

server database files 2-1 0 

soiWare 3-2, 5-6 

volume catalog A-20 
sen'er database 12-10 
seiver directories A-2 
seiver log files l6-5 

generated 16-5 

See also template log files 
slielf life, of tape and optical media 1 1-20 
software 

restore after a disaster 20-6 
SPARCsei-ver 1-9 
SRDF configuration 6-1 6 
stage-in daemon 12-7 
siage-to-cape 13-3 
staggering client staging runs 13-6 



staging 

bulk or periodic 11-2 

bulk stage in 13-10 

candidate list generation 12-5 

event-driven or demand 11-2, 11-12 

file control propeities 13-10 

manual stageout 1 3-9 

to tape 13-3 

watermarks 11-2 
staging templates 

description of 1 1-4 

how many to create 11-5 
staging trails 11-4 
siagitig ^'o]umes 

compacting 11-27, 13-28 

verifying information on 13-6 
stale files 11-27, 11-29, 11-30, 12-7, 13-28, 13-29, 
13-31 

standard rotations B-82 

how to specify B-83 

See also weekend backups 
start trailset rotations B-12 
startfind 5-4, 5-7 
startup parameter B-87 

backup of new clients B-15 
stats 

backup log level B-77 
store ID 

associated with client store 11-7 
streams from database 6-8 
striped backups, tuning 6-8 
Symmetrix Connect backup 
' EDM 6-13 

Symmetrix non-mirrored configuration 6-17 

Symmetrix Path 1-5, 6-2, 6-12 

syslog messages 15-2 

syslog.conf file 15-1, 15-6 

system 

activity log files 2-4 
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system console 

descriplion 1-10 

messages 15-1 
system logs 

newepochlog 2-7 

rotating, archiving, truncating 2-7 
system monitoring 

dbreport 11-30, 13-19 

emfsreport 11-31 lo 11-32, 13-19 to 13-23 
system monitoring support GUI 

EDM Symmetrix Connect 1-20, 1-21 

online help 1-21 

SNMP 1-20 

In'oli 1-20 

T 

tape cartj-idges. See magnetic tapes 
tape drives 

mounting volumes into 8-12 

preempting 8-1 6 

scheduling 7-13, 8-16 
tape libra ly units 1-9 

controlling 7-13 

definitions 1-9 
target ID. .SCSI 17-4 

template log files 16-36, B-13, B-14, B-78 
template_name.log file 16-36 
templates B-45 

backup 3-3 

baseline reports 16-27 
history reports 16-13, l6-l6 

volume 7-8, A-20 

See also backup templates 
tlirashing 11-6, 11-21 
tilde (~) ebadmin A-13 
timeouts 

NFS-mounted filesystenis D-10 
tmp files, deleting 10-4 



trails 5-13, B-58, 6-77 

allocating volumes to 8-23 

baseline 5-20 

default configuration 3-7 

definition of 3-8 

efficiency M'ith fewer B-60 

maximum number per media type B-24 

specification in eb.cfg B-ll 
trailsets 3-3, B-31 

alternate 3-17, 19-5, B-13, B-59, B-70, B-75, B-85 

alternating bertveen B-76 

definition of 3-3 

efficiency with fewer B-60 

fields B-9, B-1 1 

moving off site B-70 

name B-ll, B-60 

primary 3-17, 19-5, B-13, B-59, B-70, B-75 
rotations B-1 2, B-73 
specifying B-58 

starting new rotations B-1 2, B-73 

u 

uncataloged volume 7-5 
UNIX remote shell 5-4 
unlabeled volume 7-6 
unlabeled WORM 8-27 
unrestricted volume template 7-8 
unrestricted volumes 11-4 
unverified volume 7-7 
user ID 

in log messages 15-5 
user names 

backup account B-5, B-17 
user-level NFS daemon 12-4, 12-7 

y 

/var/adni/epoch_concise_messages 1 5-3 
verifying priorir\' in the queue R-16 
VERITAS 20-7 
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viiuial filesy.stem statistics 11-31 
VM_ALLOW_DL!P_SEQJMPORT 8-26 
vmdaemon 8-3, 8-5, C-5 
failures 8-5 

manual shutdown 8-5 
See also Volume Manager 
vmdup 9-3 

vmdupcfg 9-3, 9-15, 9-16 
vmdupd 9-3, 9-9, 9-15, 9-21, 9-23 
volid.dat file A-19, C-15 
volid.dat inventoiy file 8-19 
volume allocation rec]uest 8-24 
volume catalog 7-4 
volume management 

allocation, deallocation 8-1 

circular log file 15-4 

cleaning tape drives 8-22 

debug mode C-6 

directoty structure A-2 

eject media at the Cl.l 8-15 

eject media through the GUI 8-15 

Imconfig 17 2 

logs 15-1 

overview 7-2 

processes 8-2 

re-injecting volumes automatically C-19 

restarting 8-5 

starting 8-1, 8-4 

stopping 8-5 

template catalog A-20 
Volume Manager 

configuration file C-2 

daemon 8-4, C-5 

directoty 7-3 
volume reports 16-33 
volume sequenc'e numbers 

duplicate 7-5 
volumes 

allocation 8-23, 8-24 

alloGition request 8-24 



catalog 

location of A-20 
compaction 2-6 
containing backup data 16-10 
current staging 1 1-4 
dismounting 8-13 
duplicate 8-26 

duplicate seciuence numbers 7-5, 8-26 
erasing 7-7 
foreign 7-6 

inserting in a library unit 8-11 
labeling 7-4, 7-8 
labels, reading 8-12 
life cycle management 7-4 
maximum uses 18-6 
media rotation 16-10 
mount request 8-24 
mounting 8-12 
offline 7-14 
reports 16-3-4 
]-estricted by name 8-25 
restricted or unrestricted 1 l-^i 
templates A-20 
uncaialoged 7-5 
unlabeled 7-6 
unrestricted 8-25 
unverified 7-7 
use 8-25 
WOIM 8-27 
VxFS 

resen-ed files 13-12 



watermarks (HSM) 11-10 
window 

Backup Configuration 1-17 

Backup Report 1-18 

MSM Client Installation 1-21 

HSM Configuration 1-22 



EDM Software Reference 



20 

Index 



window (continued) 

Library Unit Manager 1-16 

Restore 1-19 
work groups 3-3, 3-7, 3-16 

backing up B-12 

backing up to trailseis B-58, B-6] 
backing up together B-73 
comprising work items B-31 , B-32 
custom scheduling B-15, B-82, B-84 
fields B-6, B-8 
obsolete work items B-35 
specification in eb.cfg B-31 
work items 3-3, 3-6, B-34, B-56, B-57 
backing up die local client B-38 
backup baseline reports 16-27 
backup failure reports B-80 
backup history reports 16-16 
changing B-35, B-51 
compressing catalogs B-70 
expiring backup catalogs B-68 
expiring backup data B-65, B-67 
expiring savesei records B-68 
fields B-6, B-8 

in vA'ork groups B-31, B-32, B-73 
list of fields by type of client B-34 
name B-7, B-8, B-10, B-36, B-51 
obsolete B-35 
order backed up B-7 
priority B-7 

specification in eb.cfg B-7, B-8, B-10, B-32 

specifying witli findxcpio D-7 
wwking set 1 1-13 to 1 1-15 

desctiption of 13-20 
WORM media 7-1 1 , 8-27, C-18 
WOKM optical disks 8-27 



yellow, green, prestige 11-13 
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